Skip to content

Too many requests (rate_limited)

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

HTTP status: 429

Title: Too many requests

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

{
"type": "https://docs.cafaye.com/errors/rate_limited",
"title": "Too many requests",
"status": 429,
"detail": "an example rate_limited response",
"instance": "/v1/example",
"code": "rate_limited",
"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.