Documentation
Errors
Common HTTP statuses and error codes returned by the orchestrator.
| HTTP | Code | Meaning |
|---|---|---|
| 400 | invalid_body | Malformed JSON or missing fields |
| 401 | missing_bearer / bad_signature | Auth required or invalid |
| 402 | insufficient_prepaid_credits | Metered run with no balance |
| 404 | agent_not_found / no_workspace | Unknown agent or wallet |
| 429 | rate_limited | Too many runs — backoff and retry |
| 502 | inference_unavailable | Upstream model error |
| 500 | run_failed / onboarding_failed | Unexpected server error |
Client handling
On 401 with a stored JWT, refresh by signing in again. The console clears invalid sessions to guest mode without forcing onboarding. On 402, route users to Usage to fund credits or switch to Quick ask.