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

# Limiti delle richieste API

> Budget, dimensioni e recupero prevedibile dagli errori di limite.

## Richieste al minuto

| Budget | Letture | Modifiche |
| - | - | - |
| Per chiave API | 120 | 30 |
| Per workspace, condiviso tra le chiavi | 240 | 60 |

Letture e modifiche hanno finestre fisse separate di un minuto. Il budget del workspace vale per le chiamate alle sue risorse e può esaurirsi prima di quello della chiave. Creare altre chiavi non aumenta il limite condiviso.

## Header della risposta

| Header | Significato |
| - | - |
| `X-RateLimit-Limit` | Budget della chiave per questa categoria |
| `X-RateLimit-Remaining` | Budget residuo della chiave |
| `X-RateLimit-Reset` | Fine della finestra, in secondi Unix |
| `Retry-After` | Con 429, secondi da attendere prima di riprovare |

Un `429` può dipendere dal workspace anche se la chiave ha ancora capacità. Metti il lavoro in coda, attendi almeno `Retry-After` e aumenta le attese con jitter. Prima di ripetere modifiche incerte, verificane l'esito; non cambiare la chiave dell'operazione logica.

## Dimensioni e letture

| Elemento | Limite |
| - | - |
| Pagina di una lista | 25 predefiniti, massimo 100 |
| Corpo JSON della richiesta | 256 KiB |
| Risposta CLI/MCP | 512 KiB |
| Chiave di idempotenza | 1–128 caratteri ASCII consentiti |
| Conservazione replay | Fino a 24 ore, dipende dallo storage |
| Sequenza bozza LinkedIn | Fino a 4 passaggi |

Per i report, parti da una sincronizzazione ogni cinque minuti e adatta la frequenza alle esigenze reali. È un intervallo suggerito, non una quota del provider. Per le operazioni durevoli, un [webhook](https://docs.emailx.ai/it/overview/webhooks) può avvisarti quando l’esito è pronto, senza interrogare l’API.

Se lo storage delle richieste non è disponibile, l'API restituisce `503` invece di disattivare limiti e protezione replay. Le [indicazioni sui volumi](https://docs.emailx.ai/it/overview/sending-limits.md) riguardano separatamente l'attività degli account.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.