Skip to content

Service unavailable (unavailable)

Type: https://docs.cafaye.com/errors/unavailable

HTTP status: 503

Title: Service unavailable

A reserved code. The status is fixed at 503 by the contract, so a client that sees this code can act on the status without reading further.

{
"type": "https://docs.cafaye.com/errors/unavailable",
"title": "Service unavailable",
"status": 503,
"detail": "an example unavailable response",
"instance": "/v1/example",
"code": "unavailable",
"trace_id": "0af7651916cd43dd8448eb211c80319c"
}

Contract infrastructure — this URI is permanent. PLAN §1 stability rule 2 / DECISIONS.md MD30 exempts docs.cafaye.com/errors/<code> from every docs redesign and path rewrite: a client may store this URI and dereference it years later. The only permitted change is the addition of a new <code>.

See also: the error contract index and core’s OpenAPI conventions.