request.rate_limited
Rate-limit policy rejected the request.
| Code | request.rate_limited |
|---|---|
| HTTP status | 429 |
| Category | RateLimited |
| Arguments | retryAfterSeconds, policy |
What the portals show
The portals translate the code, never the title. The English (en-GB) message, in ICU format with the arguments as placeholders:
Too many requests. Wait {retryAfterSeconds, plural, =0 {a moment} one {# second} other {# seconds}} and try again.
Example response
{
"type": "https://docs.test.konsolutelab.uk/errors/request.rate_limited",
"title": "…",
"status": 429,
"code": "request.rate_limited",
"args": {},
"traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
"instance": "/api/v1/…"
}Handling it
Branch on code, not on title or the status alone, and log traceId. Codes are stable; new codes may appear, so fall back on the HTTP status for a code you do not know. See Handling errors and the list of codes.