Default Limits
| Limit | Value |
|---|---|
| Requests per minute | 1,000 per API key |
| Max configurable | 10,000 per API key |
| Burst allowance | Up to 50 requests in a single second |
Response Headers
Every response includes rate limit headers:| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed per minute |
X-RateLimit-Remaining | Requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
Exceeding the Limit
When you exceed the rate limit, you’ll receive a429 Too Many Requests response:
Retry-After header indicates how many seconds to wait before retrying.
Best Practices
Use bulk operations
Prefer
records.bulk_create and lists.bulk_add_entry over individual calls when creating multiple items.Cache reads
Cache
objects.list and views.list responses — schemas change infrequently.Respect Retry-After
Always honor the
Retry-After header. Exponential backoff is recommended.Request higher limits
Contact support to increase your per-key limit up to 10,000 requests/minute.
Configuring Limits
Workspace owners can adjust per-key rate limits:- Go to Settings > Developers > API Keys
- Click the key you want to modify
- Set the Rate Limit field (100 to 10,000)
- Save