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
Returned when a request cannot complete because a service the API depends on is unreachable or returning a transport error. Treat as transient and retryable.
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.