Errors

Shape

{
  "error": {
    "code": "scope_denied",
    "message": "Access token lacks required scope.",
    "requestId": "req_…"
  }
}

All failures return a structured error: machine-readable code, human message, and a requestId that correlates to your request logs in the console.

Codes

unauthenticated · invalid_credential · scope_denied · rate_limited · validation_error · engine_not_entitled · internal. Map client retries on 429 and 5xx only.