Error codes

Learn about the HTTP status codes and error responses returned by the public API.

Error response format

Error responses use the ApiError schema: a JSON object with a machine-readable code and a human-readable message. Two optional fields may be present: details carries structured context when available (for example the offending fields on some validation errors), and retryAfter — set for rate_limited and service_unavailable — is the number of seconds to wait before retrying.

{
  "code": "invalid_request",
  "message": "applicationId must be a valid UUID.",
  "details": {
    "issues": [
      {
        "path": "applicationId",
        "message": "Invalid uuid",
        "code": "invalid_string"
      }
    ]
  }
}

Error codes

Status code	Error message	Description
400	Bad Request	invalid_request, unsupported_format
401	Unauthorized	Unauthorized — missing or invalid credentials
404	Not Found	not_found
413	Payload Too Large	file_too_large
422	Unprocessable Entity	unprocessable
429	Too Many Requests	rate_limited
500	Internal Server Error	Internal server error
503	Service Unavailable	service_unavailable