API errors
Common error responses and how to handle them.
API errors
API errors return JSON with an error field.
json{ "error": "Unauthorized"}
Common statuses
| Status | Meaning | Fix |
|---|---|---|
400 | The request body or parameter is invalid. | Validate against the OpenAPI spec. |
401 | Missing or invalid auth. | Check API key, session, or webhook secret. |
403 | The account or plan cannot perform the action. | Check plan limits and project access. |
404 | Resource not found. | Confirm the ID and account ownership. |
429 | Quota or rate limit reached. | Wait, reduce retries, or add credits. |
5xx | Server-side failure. | Retry with backoff and keep the original request ID if available. |
Retry guidance
Retry 429 and 5xx responses with exponential backoff. Do not retry validation errors without changing the request.