type URI on every service_degraded problem body: https://docs.get-exo.com/errors/service_degraded.
HTTP status: 503 Service Unavailable.
Why it happens
The API never returns 500 for a dependency failure. When the token verifier, the subject store, the idempotency store or the webhook store cannot be reached, the request fails as 503 so a client can tell ‘retry this’ apart from ‘fix your request’. A 503 on webhook registration has one non-transient cause worth knowing: a deployment with no webhook signing key configured refuses registration rather than storing a secret it cannot protect.How to fix it
- Retry with exponential backoff. The request did not partially apply.
- If the call carried an
Idempotency-Key, reuse the same key on the retry. That is what the key is for. - If 503s persist on one family rather than all of them, quote the
requestIdand the route when you report it.
Related
rate_limit_exceeded- Errors for the envelope and the full catalogue