Skip to content

Error Handling

Handle the standard error envelope and HTTP status codes consistently.

  • UNAUTHORIZED (401) — missing/invalid credentials
  • FORBIDDEN (403) — missing permission or isolation failure
  • INVALID_REQUEST (400) — validation failure
  • NOT_FOUND (404) — resource missing for caller
  • CONFLICT (409) — idempotency or uniqueness conflict
  • RATE_LIMITED (429) — too many requests

Sourced from backend developer guide and OpenAPI. If a field is missing from the published contract, it is intentionally omitted here.