Error codes
upstream.unavailable
A downstream dependency the dashboard or backend relies on is unreachable.
upstream.unavailable is returned at HTTP 502, 503.
When this fires
The dashboard BFF emits this when the v1 backend is unreachable (timeout, connect failure, 5xx). Some backend endpoints emit it when an external dependency (WorkOS, Postgres, Redis) returns a transport error.
What to do
This is transient — retry with exponential backoff. The Python SDK raises ServerError (safe to retry on 503 only) and the TypeScript SDK throws ServerError. If the condition persists more than a few minutes, check the Sonny Labs status page.
See also
- SDK reference — the Python and TypeScript SDKs raise typed exceptions for codes in this namespace.
- Error code index — every code the runtime can return.