# rate_limited

**HTTP 429 — Rate limited**

## When you see it

A rate bucket is exhausted.

## What to do

Wait `Retry-After` seconds. Watch `RateLimit-Remaining` on every response and slow down before you are cut off — the limits are documented at /rate-limits.

## The response

Every error is [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem+json:

```json
{
  "type": "https://devs.inittasks.com/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "detail": "a sentence for a developer; never branch on it",
  "instance": "/todos/8E4F2A1B",
  "request_id": "3f9a1c7e-2b44-4d1e-9c30-5a7e8b2d1f60",
  "retry_after": 42
}
```

// Branch on `type`, never on `detail` or on the HTTP status alone — several codes share a status.