Skip to main content
All API keys are rate-limited to protect the platform and ensure fair usage across workspaces.

Default Limits

LimitValue
Requests per minute1,000 per API key
Max configurable10,000 per API key
Burst allowanceUp to 50 requests in a single second

Response Headers

Every response includes rate limit headers:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1711180800
HeaderDescription
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the window resets

Exceeding the Limit

When you exceed the rate limit, you’ll receive a 429 Too Many Requests response:
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "retry_after": 12
  }
}
The 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:
  1. Go to Settings > Developers > API Keys
  2. Click the key you want to modify
  3. Set the Rate Limit field (100 to 10,000)
  4. Save