Skip to content

Error Codes

Code HTTP Status Description
invalid_token 401 API token is invalid or expired
insufficient_scope 403 Token lacks required scope
not_found 404 Requested resource does not exist
content_too_large 413 File exceeds maximum upload size
unsupported_format 415 File format not supported for transcoding
rate_limited 429 Too many requests
transcode_failed 500 Transcoding pipeline error
service_unavailable 503 Service temporarily unavailable

All errors follow the standard envelope:

{
  "status": "error",
  "error": {
    "code": "not_found",
    "message": "Content not found: c_nonexistent",
    "request_id": "req_a1b2c3d4"
  }
}