Error types

Errors are returned as JSON with a stable error.code.

Example:

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests",
    "retryable": true
  }
}

Common errors

HTTP	error.code	Retryable	Notes
400	invalid_request	no	Fix request body/params
401	unauthorized	no	Invalid/missing credentials
403	insufficient_scope	no	Missing scope
404	not_found	no	Wrong ID or endpoint
409	conflict	sometimes	State conflict; may require fetch + retry
429	rate_limited	yes	Backoff and retry
500	internal	yes	Backoff and retry
503	unavailable	yes	Backoff and retry

---

Next: Getting Started · Reference · Changelog · Support