Reference

Error codes

Errors should tell you what went wrong, what to do next, where to read more, and the request_id for support.

Envelope

JSON errors include an error code, message, docs_url when available, and request_id. The same request ID is returned in X-Request-Id.

Common codes

Runtime error codes are lowercase. `unauthorized` means add valid credentials, `forbidden` means use the correct key type or origin, and `rate_limited` means back off using Retry-After.

validation_error

validation_error means fix request body shape.

not_found

not_found means the resource is missing or outside the authenticated scope.

Support

Include request_id, endpoint, key mode, and environment when asking for help. Never include full API keys.

429 rate-limit response

Use the Retry-After header before retrying a rate_limited response.

429-rate-limited.http

text

HTTP
HTTP/1.1 429 Too Many RequestsRetry-After: 60X-Request-Id: req_demo_rate_limit{  "error": {    "code": "rate_limited",    "message": "Rate limit exceeded."  }}

Need rollout review?

Start with the Server API. Use contact only when you need rollout review, enterprise coordination, or non-standard integration help.

Contact the team