> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# Rate limits

> The per-key request budget and its headers.

Each API key has a request budget per time window. By default that is 600
requests per 60 seconds.

Successful responses carry the budget in headers:

| Header                | Meaning                                  |
| --------------------- | ---------------------------------------- |
| `RateLimit-Limit`     | Requests the key may make per window.    |
| `RateLimit-Remaining` | Requests left in the current window.     |
| `RateLimit-Reset`     | Seconds until the current window resets. |

When the budget is spent, requests are refused with `429` and the code
`rate_limited`. The `Retry-After` header says how many seconds to wait.

```json api op=list_clusters status=429
{
  "error": {
    "code": "rate_limited",
    "message": "This API key made too many requests. Try again in 12 seconds."
  }
}
```

Spread requests out, and wait for `Retry-After` before you retry.
