RESPONSES

Error format

API errors return JSON with a machine-readable code, a human-readable message, and a request ID.

Missing API key

{
  "ok": false,
  "error": {
    "code": "missing_bearer_token",
    "message": "Authorization: Bearer <API_KEY> is required."
  },
  "request_id": "..."
}

Common HTTP status codes

Status	Meaning
`200`	Success
`401`	Missing, invalid, revoked, or expired API key
`405`	Method not allowed
`429`	Rate limit exceeded
`503`	API/database health degraded