API
Rate Limits
Windows, headers and what to do on 429.
Limits are counted in fixed windows per credential and route group. Responses carry X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset; a 429 also has Retry-After (seconds). The SDK waits and retries automatically.
| Bucket | Default |
|---|---|
| Agent API (all agents of a project share it) | 1200 requests / 60 s |
| Command writes | 40 / 60 s |
| Interaction callbacks | 50 / 10 s |
| Messages sent | 12 / 10 s |
| Uploads | 20 / 60 s |
| OAuth token & revoke | 60 / 60 s per IP |
| Delivery test / command test (portal) | 10 and 20 / 60 s |
The platform may lower limits temporarily under load. The live values and your current usage are always in your project's Limits section.