REST API v1

Error contract

Respond safely to validation, authentication, authorization, quota, and server errors.

Updated 2026-07-24

Error handling

Treat 400 responses as invalid input that should not be retried unchanged.
Treat 401 and 403 responses as credential or scope issues.
Back off when a 429 response indicates a quota or rate limit.
Retry eligible 5xx responses with bounded exponential backoff and jitter.

Example error

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The request is invalid",
    "details": []
  },
  "meta": { "requestId": "req_01..." }
}