API error responses and troubleshooting
HTTP status codes
| Status | Meaning | Action |
|---|---|---|
| 200 | Success | — |
| 400 | Bad request | Check parameters |
| 401 | Auth failure | Check API Key |
| 403 | Forbidden | Request permissions |
| 404 | Not found | Verify ID |
| 429 | Rate limited | Backoff and retry |
| 500 | Server error | Retry, contact support if persistent |
Error response
Retry strategy
| Error type | Retry? | Interval |
|---|---|---|
| 4xx (except 429) | No | — |
| 429 rate limited | Yes | 1s/2s/4s exponential backoff |
| 5xx | Yes | 1s/2s/4s, max 3 retries |
Troubleshooting
Every response includes request_id. Provide this ID when contacting support for faster resolution.