Operations

Errors

Handle standard error responses consistently across the external API.

Standard Error Envelope

Example Error Responsejson

{
  "success": false,
  "request_id": "req_example_123",
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily rate limit exceeded for this API key"
  },
  "meta": null
}

Common Error Cases

401 when the API key is missing, invalid, or revoked
403 when the tenant lacks permission or the subject is not assigned
404 when the requested resource does not exist for that tenant context
409 when an idempotency key is reused with a different payload
429 when minute or daily request budgets are exhausted
500 for unexpected server-side failures