Errors

One shape, every time. Real HTTP status codes, and never a 200 containing an error.

{
  "error": {
    "type": "invalid_request",
    "code": "media_too_large",
    "message": "Document is 118.4 MB. The limit is 100 MB.",
    "param": "document",
    "docs": "https://docs.njiwa.upeo.ai/errors/media_too_large"
  }
}

type is one of invalid_request, authentication_error, permission_error, not_found, rate_limit, instance_error, api_error.

Branch on code, not on the message. Messages are written for humans and we improve them; codes are the contract.

All 288 codes