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

# Rate limits

> Get2Dial API rate limits by request type, how to read a 429 response, and how to back off correctly.

Rate limits are enforced per workspace using a token bucket, so a short burst above the
sustained rate doesn't fail immediately.

<Snippet file="limits-table.mdx" />

## Custom key limits

When you [create an API key](/developers/authentication), you can set a custom
**Rate limit (requests / minute)** for that key specifically, overriding your workspace's
default for requests made with it.

## Handling a 429

A request that exceeds its bucket returns `429` with a `Retry-After` header (whole seconds)
and a body telling you exactly when to retry:

```json theme={null}
{ "retry_after_seconds": 3 }
```

Back off for that long before retrying — a tight retry loop against a rate limit only
extends the throttle. See [Errors](/developers/errors) for the general error shape.

## Related

<CardGroup cols={2}>
  <Card title="Errors" href="/developers/errors" />

  <Card title="Limits and quotas" href="/reference/limits-and-quotas" />
</CardGroup>