Rate Limits

To prevent abuse and protect downstream models.

Default Quotas

Response Headers

Every response includes rate-limit status:

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 18
X-RateLimit-Reset: 1715154000

Over-Limit Response

HTTP/1.1 429 Too Many Requests
Retry-After: 1

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 1 second."
  }
}

Recommended Backoff

attempt 1 → immediate
attempt 2 → 1s
attempt 3 → 2s
attempt 4 → 4s
attempt 5 → 8s
give up

Honor Retry-After if present; otherwise, use the defaults above.

High-Concurrency Scenarios

If your business truly needs higher concurrency:

1. Contact sales to raise the quota
2. Private deployment is not subject to SaaS quotas
3. Architectural: use Webhooks + async, not aggressive polling

Next Steps

• Webhooks · Async events
• Errors