Error Responses

When an API request fails, a structured error object is returned containing:

code: a machine-readable error code for programmatic handling

message: a human-readable explanation of the issue

Example response

{
  "code": "invalid_access_token",
  "message": "Access token is invalid"
}

Error codes

The docs list the following possible error codes:

internal_error, invalid_field, invalid_header_value, permission_denied, too_many_requests,
not_found, bad_request_body, bad_http_method, bad_request_params, bad_query_params,
endpoint_not_found, unsupported_version, invalid_access_token, revoked_access_token,
missing_field, missing_scope, invalid_grant, invalid_request, invalid_client,
unauthorized_client, unsupported_grant_type, invalid_scope, invalid_basic_header,
invalid_file_format, unsupported_content_type, request_too_large,
asset_not_found, max_limit_reached,
permission_not_found, permission_exists, unauthorized_user, user_not_found

Handling errors (example)

Troubleshooting common errors

Error Code	What It Means	How to Troubleshoot
`invalid_access_token`	Access token is malformed, expired, or invalid.	Ensure token format is correct. Refresh or re-authenticate.
`permission_denied`	User lacks access to the resource.	Notify the user or check permission scopes.
`missing_scope`	Required scope not granted during auth.	Add missing scope and re-authorize.
`not_found`	Resource doesn't exist or is inaccessible.	Confirm ID and user access. Resource may have been deleted.
`too_many_requests`	Rate limit exceeded.	Implement exponential backoff and retry strategy.
`bad_request_body`	Malformed or invalid request body.	Check request body format and required fields.
`invalid_field`	One or more fields contain invalid data.	Refer to API docs for correct field formats.
`internal_error`	Unexpected server issue.	Retry after delay.

Error Responses

Error Responses#

Example response#

Error codes#

Handling errors (example)#

Troubleshooting common errors#

Error Responses

Example response

Error codes

Handling errors (example)

Troubleshooting common errors