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

# Rate Limits

> Limites de requisições da API do Synax

# Rate Limits

A API do Synax aplica limites de requisições para garantir estabilidade.

## Limites por endpoint

| Endpoint                          | Limite   | Janela     |
| --------------------------------- | -------- | ---------- |
| REST API (`/rest/v1/`)            | 1000 req | por minuto |
| Edge Functions (`/functions/v1/`) | 300 req  | por minuto |
| Auth (`/auth/v1/`)                | 30 req   | por minuto |

## Headers de resposta

Toda resposta inclui headers de rate limiting:

```
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 997
X-RateLimit-Reset: 1709136000
```

## Quando exceder o limite

Ao exceder, a API retorna status **429 Too Many Requests**:

```json theme={null}
{
  "message": "Rate limit exceeded",
  "retryAfter": 30
}
```

<Tip>
  Use o header `Retry-After` para saber quando tentar novamente.
</Tip>

## Boas práticas

* Use paginação (`limit` e `offset`) para listar muitos registros
* Cache respostas quando possível
* Implemente retry com backoff exponencial
* Agrupe operações em batch quando a API suportar