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. Live service status: https://wyroapi.com/en/status.