Skip to content

Not found (not_found)

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

HTTP status: 404

Title: Not found

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

{
"type": "https://docs.cafaye.com/errors/not_found",
"title": "Not found",
"status": 404,
"detail": "an example not_found response",
"instance": "/v1/example",
"code": "not_found",
"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.