> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# rate_limited

> Rate limited. HTTP 429, retryable.

**HTTP 429: Rate limited.** Retry the request: wait for `Retry-After` when the response has one. Errors never cost API credits.

Over the plan's requests per minute, per key or per workspace. Every response carries `RateLimit-Policy` and `RateLimit` headers; wait for `Retry-After`.

**What to do:** Wait for Retry-After, then retry.

```json Response theme={null}
{
  "type": "https://docs.alura.io/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "Rate limited",
  "suggestion": "Wait for Retry-After, then retry.",
  "retryable": true,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}
```

The response is `application/problem+json` (RFC 9457) and has a `Request-Id` header with the same `request_id`. See [all errors](/api-reference/errors).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.