Discovery API

Error Codes

Mode uses conventional HTTP response codes to indicate the success or failure of a Discovery API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a task failed, etc.).

Our API resources can produce errors for many reasons, such as invalid parameters, authentication errors, and rate limits.

400 Bad Request

This response is given any time the request was malformed, either with query parameters that are improper, or a request body that is unusually structured or with unsupported inputs.

Properties	Type
id required	string enum: bad_request
message required	string

401 Unauthorized

This response is given any time a request is made against a resource or endpoint that requires an authorization and none was provided.

Properties	Type
id required	string enum: unauthorized
message required	string

404 Not Found

This response is given any time a resource required to fulfill the request could not be found. After seeing this error, ensure that the account in the request path is correct and the Signature Token included in the Authentication is valid.

Properties	Type
id required	string enum: not_found
message required	string