What do all the Agent API error codes mean?
Errors are JSON with a stable code and a human-readable message:
{ "error": { "code": "out_of_credits", "message": "You're out of Clatter Labs credits. ..." } }
| Status | code | What to do |
|---|---|---|
| 400 | bad_request | Missing input or a bad tier: fix the request |
| 401 | invalid_api_key | Check the key, or create a new one |
| 401 | missing_account_id | Send X-Clatter-Account |
| 401 | account_mismatch | Use the key owner's Account ID |
| 402 | out_of_credits | Add credits |
| 403 | insufficient_scope | Create a key with that permission |
| 403 | early_access | Ask for access |
| 403 | no_cloud_account | Set up Cosmos Agent for the account, then retry |
| 403 | account_suspended | Wait until resets_at, or appeal |
| 404 | not_found | Check the run id |
| 405 | method_not_allowed | Use the right HTTP method |
| 413 | too_large | Trim input, metadata or the body |
| 429 | rate_limited | Wait Retry-After seconds |
| 429 | too_many_runs | Wait for or cancel a run |
| 502 | upstream | Retry with backoff |
| 503 | unavailable | Retry with backoff |
Branch on code, not on message. See Errors.
Related articles
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.