Rate Limits
All API requests are rate-limited per workspace and MCP key.
Default Limits
- 120 requests per minute
- Burst limit: 30 requests in 10 seconds
When Limits Are Exceeded
When you exceed a limit, the API returns HTTP 429 Too Many Requests. The response includes a Retry-After header indicating how many seconds to wait before retrying.
{
"error": "rate_limit_exceeded",
"message": "Too many requests. Please retry after the time indicated in the Retry-After header."
}
Check the Retry-After header value and wait at least that many seconds before sending another request.
Best Practices
- Cache repeated lookups — avoid fetching the same account or post list on every request.
- Retry with backoff — when you receive a 429, wait for the
Retry-Afterduration before retrying; use exponential backoff for repeated failures. - Batch where possible — combine related operations instead of sending many rapid individual requests.