Unauthorized (unauthorized)

unauthorized

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

HTTP status: 401

Title: Unauthorized

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

Example

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

Stability

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.