rate_limited
Too many requests
| Used as | Top-level code, HTTP 429. |
| Retryable | after |
| Since | API version 2026-11-01 |
Extension members: limit_scope, retry_after_ms.
Messages#
| Language | Title | detail template |
|---|---|---|
| en | Too many requests | Limit reached for {limit_scope}. Retry in {retry_after_s} s. |
| de | Zu viele Anfragen | Limit erreicht ({limit_scope}). Erneut versuchen in {retry_after_s} s. |
title is fixed English text and never varies per occurrence; detail follows Accept-Language and is for people only. Clients switch on code (and detail_code or failed_preconditions[].code), never on detail. A client that does not know a code falls back to the HTTP status class.
Example#
JSON
{
"type": "https://docs.hive.clerktree.com/errors/rate_limited",
"title": "Too many requests",
"status": 429,
"detail": "Limit reached for credential. Retry in 3 s.",
"instance": "/v1/assets",
"code": "rate_limited",
"request_id": "req_01m71xxqhkf9avn6dq2sfgzgym",
"retryable": true,
"limit_scope": "credential",
"retry_after_ms": 2400
}