Limits & Plans
Usage is governed by your subscription plan. When a numeric limit is exceeded or a feature is not included in your plan, the API responds with 403 Forbidden and details about the limit. Bursty traffic is additionally rate-limited with 429 Too Many Requests.
Plan limits
There are five plans — Free, Start, Pro, Business and Enterprise. Each sets quotas for the resources below. See your current quotas in the dashboard under Plans.
| Type | Description |
|---|---|
sites | Number of sites/projects |
messages_per_month | AI messages per month |
tokens_per_month | AI tokens per month |
knowledge_chunks | Knowledge base entries |
operators | Team operators |
analytics_days | Analytics retention window |
Feature gating
Some capabilities are only available on higher plans, e.g. custom prompt, branding removal, Telegram, AI crawling, auto-translation, visitor monitoring, photo upload and visitor details. Calling a gated feature on a plan that does not include it returns 403.
Rate limiting
Requests are throttled per client. When you hit the limit you receive 429; auth endpoints use progressive blocking and return retry_after (seconds) and blocked_until.
{
"success": false,
"error": "Too many failed attempts. Try again in 15 min.",
"retry_after": 900,
"blocked_until": "2026-06-03T19:00:00+00:00"
}