Forbidden (forbidden)

forbidden

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

HTTP status: 403

Title: Forbidden

A reserved code. The status is fixed at 403 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/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "an example forbidden response",
  "instance": "/v1/example",
  "code": "forbidden",
  "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.