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

# rate-limit-exceeded

> 429 — over the hourly allowance

<Info>
  **Quick Summary:** The key exceeded its hourly allowance for this request class. Wait for the window to reset — the `Retry-After` header says how many seconds.
</Info>

## What happened

Every response carries the current window state in headers:

| Header                | Meaning                                  |
| --------------------- | ---------------------------------------- |
| `RateLimit-Limit`     | The allowance for this request bucket    |
| `RateLimit-Remaining` | Requests left in the current hour window |
| `RateLimit-Reset`     | Seconds until the window resets          |

Requests are counted per key in three buckets — reads (GET), writes (POST/PUT/PATCH/DELETE) and bulk operations. See [rate limits](/api-docs/rest/rate-limits) for the numbers.

## What to do

Back off until `Retry-After` elapses, then resume. Well-behaved integrations watch `RateLimit-Remaining` and slow down *before* hitting zero. If your integration legitimately needs more, ask your SkillsDB contact about a per-key allowance.