Limits and errors
Default usage limits and HTTP error codes.
Limits
| Limit | Default |
|---|---|
| Concurrent sessions | 10 |
| Turn timeout | 90 minutes |
| Session TTL | 4 hours (overridable per-call via ttl) |
| Hourly turns | 300 |
| Hourly tokens | 20M |
| Daily turns | 5000 |
| Daily tokens | 200M |
| Max upload size | ~100 MB per call |
| Max workspace size | 100 GB |
Any of these can be raised on request.
Error codes
| Status | Meaning |
|---|---|
400 | Malformed request body or invalid params |
401 | Bearer token missing or invalid |
402 | Insufficient credits (hard mode only) |
403 | Path outside session scope, or invalid file path |
404 | Session not found, file not found, endpoint not enabled |
409 | Session is busy with another message |
413 | Upload exceeds size limit |
416 | Bad Range header |
429 | Usage limit exceeded |
500 | Server error — please retry with backoff |
503 | Service degraded (rare) |
Error body shape: {"error": "<short_name>", "message": "<human description>"}.