# Limits

## Rate limits

| What | Limit | Applies to |
| --- | --- | --- |
| Requests per key | **120 per minute** | Every authenticated call (`/v1/*` with a key, MCP tools). A partner acting with `X-Wyro-External-Id` counts against that client's key. |
| Requests per IP | **300 per minute** | Calls without a workspace key: `POST /v1/sandbox` and the partner API (`/v1/partner/*`). |
| Test keys | **5 per IP per hour** | `POST /v1/sandbox` (`sandbox_limit`). |
| Real posts on a trial | **25 per day** | Posts to real accounts with a key that is not on a paid plan. |

The windows slide: the limit counts the calls of the last minute (or hour, or day), not a calendar minute.

When you go over, the answer is `429` with:

| Header | Meaning |
| --- | --- |
| `Retry-After` | Seconds to wait before retrying. |
| `X-RateLimit-Limit` | The limit you hit. |
| `X-RateLimit-Remaining` | Calls left in the window (`0`). |

The SDKs wait for `Retry-After` and retry on their own.

## Sizes

| What | Limit |
| --- | --- |
| Media per post | 10 |
| Direct upload to `POST /v1/media` | 4 MB (larger files: presigned upload) |
| Posts per page in `GET /v1/posts` | 100 |
| Test key lifetime | 72 hours |
| `Idempotency-Key` | 255 characters, remembered 24 h |
| Webhook attempt | 5 s, 8 attempts |

Text limits per network are in [Publish](https://wyroapi.com/en/docs/publish). Live service status: [https://wyroapi.com/en/status](https://wyroapi.com/en/status).
