API guides
Errors and retries
Respond safely to validation, throttling, payment, and service errors.
| Status | Meaning | Client action |
|---|---|---|
400 | Invalid input | Correct the request; do not retry unchanged. |
402 | x402 payment required | Select an accepted payment option and retry with the payment signature. |
404 | Resource not found | Verify both chain ID and agent ID. |
429 | Rate limit reached | Back off and retry with jitter. |
5xx | Temporary service failure | Retry a bounded number of times with exponential backoff. |
Never retry immediately in a tight loop. For writes or paid requests, retain enough request state to avoid unintentionally repeating a settled operation.