Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 402 | Insufficient prepaid budget |
| 403 | Key revoked or account suspended |
| 404 | Unknown model or route |
| 429 | Rate limited — retry with backoff |
| 502/503 | Upstream provider or gateway unavailable |
Response body
Errors follow provider-native JSON where possible. OctaRouter may wrap failures with a message or error field.
Dashboard auth errors
Portal API routes return { "success": false, "error": "..." } with appropriate HTTP status codes.