Reference
Limits
Rate limits, payload and field limits, knowledge pack sizes, and how long data is kept.
Rate limits
| Surface |
Limit |
Window |
Keyed by |
POST /v1/capture |
40 requests |
15 minutes |
Site key |
/v1/engage/* (all public endpoints) |
120 requests |
15 minutes |
Site key |
POST /v1/engage/chat |
12 messages |
1 minute |
Site key + visitor IP |
Every authenticated response includes RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (seconds). Over the limit you receive 429.
Payload limits
| Item |
Form Capture |
Engage (Forms · Support · Chat) |
| Fields per submission |
20 |
24 |
| Field name |
40 chars, A–Z a–z 0–9 _ - |
40 chars, A–Z a–z 0–9 _ - |
| Field value |
2,000 chars |
2,000 chars |
form label |
40 chars |
40 chars |
page |
200 chars |
300 chars |
| Chat message |
— |
2,000 chars |
Support message |
— |
5,000 chars |
Idempotency-Key |
8–100 chars |
8–100 chars |
| Honeypot handling |
Your server |
website, url, homepage dropped |
Site configuration limits
| Item |
Limit |
| Allowed origins (Engage) |
10 per site |
| Knowledge articles |
40 per site, 8,000 characters each, 10 tags each |
| Knowledge context |
6,000 characters |
| Assistant name |
40 characters |
| Launcher label |
60 characters |
| Greeting |
400 characters |
| Webhook URL |
400 characters, HTTPS |
| Active keys |
1 per site |
Retention
| Data |
Kept for |
| Form Capture submissions, Engage tickets and conversations |
The life of the site |
Raw visitor IP sent in Form Capture context.ip |
30 days, then removed; the derived country stays |
| Site keys |
Hash only, indefinitely; revoked keys remain as revoked records |
| Engage visitor token (browser) |
Until the visitor clears site data; it identifies a thread, not a person |
