Errors
Common API error status codes.
Errors are returned as JSON. Validation errors may include schema parsing details.
| Status | Meaning |
|---|---|
| 400 | Invalid input, route parameter, or query parameter |
| 401 | Missing or invalid bearer token |
| 402 | Not enough credits for a credit-gated operation |
| 403 | Authenticated but not allowed in the selected scope/workspace |
| 404 | Requested record or reference was not found |
| 409 | Conflict, such as an invalid state transition or duplicate constraint |
| 429 | Rate limited, especially OTP creation |
| 500 | Unexpected server error |
| 502 | Upstream service returned an invalid or failed response |
Retry only 429 and transient 5xx responses, and use backoff.