← Back to Documentation
Troubleshooting
Error Messages
Interpret common HTTP, auth, quota, provider, and server errors.
Key Steps
- 401 and 403 usually mean authentication, organization, or role problems.
- 429 means a quota or rate limit protected the deployment.
- 5xx errors require provider or server investigation with request IDs.
Article Scope
This guide focuses on the operational steps needed to run Orchestris with team access, provider control, and predictable usage.
401 and 403
- Confirm the user is signed in to the correct organization.
- Check whether the account is active and has the right role.
- For deployment calls, verify the deployment secret and portal configuration.
429
- Wait for the retry window instead of retrying immediately.
- Review user quotas and automation behavior.
- Increase limits only after confirming the workload is expected.
5xx
- Capture request IDs, provider, model alias, and time window.
- Check provider health and server logs.
- Use fallback models or pause rollout if errors affect core workflows.