Errors
Failed requests return a consistent JSON error body.
Response shape
json
{
"success": false,
"error": "Human-readable message",
"code": "AUTH_REQUIRED",
"details": "Optional detail"
}Common codes
| Code | Typical meaning |
|---|---|
| AUTH_REQUIRED | Missing or invalid credentials |
| INVALID_API_KEY_FORMAT | Key does not look like sk_… |
| INVALID_API_KEY | Key rejected (revoked, expired, or wrong) |
| INVALID_TOKEN | Session or JWT invalid |
| NOT_FOUND | Resource missing |
| BAD_REQUEST | Validation or malformed input |
| RATE_LIMITED | Too many requests |
| INTERNAL_ERROR | Unexpected server error |
Clients should read error and optional code from the JSON body. See Rate Limits for 429 behavior.