Error response
JSON
{
"error": {
"code": "rate_limited",
"message": "Too many requests",
"request_id": "req_01J4N7"
}
}When to retry
| Status | Action |
|---|---|
| 400 / 422 | Fix the request; do not retry unchanged |
| 401 / 403 | Fix credentials or permissions |
| 429 | Retry after the indicated delay |
| 5xx | Retry with exponential backoff and jitter |
Keep request IDs
Record the request ID, job ID, status code, and attempt count. This is the fastest route to resolving production incidents.