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

# Rate Limits

> Per-project API rate limits and how to handle them

Bota enforces per-project rate limits to protect platform stability.

| Scope          | Limit                 |
| :------------- | :-------------------- |
| All endpoints  | 100 requests / minute |
| Upload URLs    | 30 requests / minute  |
| Transcriptions | 10 requests / minute  |

### Response Headers

Rate limit headers are returned on every request:

```
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705312800
```

### Handling 429s

* Back off with exponential retry.
* Prefer webhooks over polling.
* Cache read-heavy data when possible.