API v1
Errors
API v1 returns stable JSON error envelopes.
Errors use this shape:
{
"error": {
"code": "unauthorized",
"message": "Invalid bearer token."
},
"meta": {
"request_id": "req_..."
}
}Common status codes:
| Status | Meaning |
|---|---|
400 | Invalid request payload or query parameter |
401 | Missing, invalid, expired, or revoked bearer token |
403 | Bearer token is missing a required scope |
404 | Resource not found or not owned by the token profile |
402 | Insufficient credits (INSUFFICIENT_CREDITS) |
429 | Rate limit exceeded |
500 | Internal server error |