503 — Upstream unavailable
When the provider is down, HiWay tells you which one.
json
{
"error": {
"message": "Upstream provider unavailable: anthropic (gateway 503)",
"type": "upstream_error",
"provider": "anthropic",
"upstream_status": 503
}
}What HiWay did
HiWay tried the routed provider and got an error back. It does not retry automatically against a different provider, because that would change the model and therefore the behavior — and most of our customers depend on deterministic routing. The decision to fail over is yours.
How to build failover
- Catch the
503in your client code. - Retry the same request with a pinned alternative: e.g. if the routed tier was
standard→ claude, pinopenai:gpt-4o-miniand resend. - Log both attempts so you can see the failover rate in your observability.
Check the status page first
Most 503s match a provider-wide incident. Check status.anthropic.com / status.openai.com / status.mistral.ai before opening a HiWay ticket.