API
Errors and retries
Handle validation, authorization, conflicts, limits, and temporary failures.
Status codes
| Status | Meaning | Action |
|---|---|---|
| 400 | Invalid request | Correct the input; do not retry unchanged. |
| 401 | Authentication failed | Check the key and Bearer header. |
| 403 | Scope or role denied | Use an authorized role and the required scope. |
| 404 | Resource not found | Confirm the id and active organization. |
| 409 | State conflict | Refresh state and resolve the conflict. |
| 429 | Rate limited | Retry with exponential backoff and jitter. |
| 5xx | Temporary service failure | Retry idempotent work with bounded backoff. |
Safe retry policy
text
attempt 1: wait about 1 second
attempt 2: wait about 2 seconds
attempt 3: wait about 4 seconds
add random jitter to each delay
stop after a bounded number of attemptsDo not automatically retry a call-trigger request unless your application can prove that a call was not already accepted.