Error Responses
Standard HTTP status codes. Error bodies carry a detail string:
{ "detail": "Custodian not found" }
| Status | Meaning | Check |
|---|---|---|
400 | Malformed request | Request shape |
401 | Key missing / invalid / inactive | X-API-Key header and key status |
403 | Key expired | Renewal date in the Dashboard |
404 | Agent / app / squad not found | app_id / team_app_id, and that it's yours |
422 | Body failed validation | Compare with Chat |
429 | Token or request limit hit | Usage in the Dashboard |
5xx | Platform or upstream failure | Retry with backoff |
The SDKs retry 5xx and network errors automatically (two retries by default). For
raw HTTP, retry idempotent failures with a short backoff.