Limits and errors
Limits keep one busy store or one noisy site from slowing everyone else. The defaults sit well above what a busy team does.
Default limits per workspace
| What | Limit |
|---|---|
| Website visitor questions | 120 a minute, plus per visitor and per address daily caps |
| Merchant messages | 600 a minute for the workspace, 30 a minute per store |
| AI replies | 120 a minute and 20,000 a month |
| AI usage | 400 million tokens a month, 600 AI calls a minute |
| Team invites | 20 a day |
| Help center domain requests | 5 a day |
Limits can be raised per workspace; tell us what you need.
When the AI reaches its monthly cap
The AI stops answering for the rest of the month and conversations stay with your team. The inbox notes it once on the conversation, and the AI tab in Settings shows this month's usage.
Errors
| Status | Meaning |
|---|---|
400 | The request is malformed (a missing field, a value out of range). |
401 | Not signed, or the signature, purpose or expiry is wrong. Check the secret and your server's clock. |
403 | Signed, but not allowed: an app or site not registered to a workspace, or a role that cannot do this. |
404 | Not found in your workspace. Items of other workspaces always look like this. |
409 | Already taken: a client id, domain or secret change that conflicts. |
429 | A limit was reached. Wait a minute and try again. |
Errors answer with JSON { "error": "..." } in plain words.