> ## 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.

# API request limits

> Request budgets, payload limits and a predictable way to recover.

## Requests per minute

| Budget | Reads | Writes |
| - | - | - |
| Per API key | 120 | 30 |
| Per workspace, shared across keys | 240 | 60 |

Reads and writes use separate fixed one-minute windows. Workspace budgets apply to workspace calls and can be exhausted before a key's own budget. Creating more keys does not increase the shared workspace allowance.

## Response headers

| Header | Meaning |
| - | - |
| `X-RateLimit-Limit` | Key budget for this read/write category |
| `X-RateLimit-Remaining` | Remaining key budget |
| `X-RateLimit-Reset` | End of the window, Unix seconds |
| `Retry-After` | On 429, seconds to wait before trying again |

A `429` can come from the shared workspace budget even when the key has remaining capacity. Queue work, wait at least `Retry-After`, and add backoff with jitter. Reconcile uncertain writes before retrying; do not change the logical-operation key.

## Size and retrieval limits

| Item | Limit |
| - | - |
| List page | Default 25, maximum 100 |
| JSON request body | 256 KiB |
| CLI/MCP response | 512 KiB |
| Idempotency key | 1–128 allowed ASCII characters |
| Replay retention | Up to 24 hours, storage-dependent |
| LinkedIn draft sequence | Up to 4 steps |

Begin reporting syncs at a five-minute interval and adjust to actual need. This is a suggested polling interval, not a new provider quota. For durable operations, a [webhook](https://docs.emailx.ai/en/overview/webhooks) can tell you when the outcome is ready instead of polling.

If request storage is unavailable, the API fails with `503` rather than disabling rate limits or replay protection. [Provider and sending guidance](https://docs.emailx.ai/en/overview/sending-limits.md) covers account activity separately.


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