Developers / REST API
Rate limits
Available on the Max plan.
Limits are counted per project, all tokens together.
| Scope | Limit |
|---|---|
Reads (GET) |
120 per minute |
Writes (POST, PATCH, DELETE) |
60 per minute |
| All requests | 50 000 per day |
POST /conversations/{id}/transcript |
20 per hour |
Every response tells you where you stand:
RateLimit-Limit: 120
RateLimit-Remaining: 117
RateLimit-Reset: 42
Over the limit, the API answers 429 with rate_limit_exceeded and a Retry-After header, in seconds. Wait that long, then retry.
Two habits keep you far from the limits: use webhooks instead of polling for new messages, and list with limit=100 and updated_since instead of fetching resources one by one.