Limits & errors
Every number the platform enforces, in one place, so you never have to hunt for a cap in a guide.
Runtime
| What | Limit |
|---|
| Wake from sleep | About a second, automatic on any message, trigger, or request |
| Chat reply budget (custom agents) | Reply within 30 seconds; run longer work in the background and deliver it on the next message |
| exec (run a command) | 60s default timeout, 120s max; output is one merged stream capped at 256 KB |
| File transfers | 100 MB per file; any file call wakes a sleeping agent |
Build & deploy
| What | Limit |
|---|
| Typical repo build + ship | 1 to 3 minutes (an idle builder cold-starts first, adding about a minute) |
| Silent build kill | A build that prints nothing for 5 minutes is killed |
| ZIP upload | 500 MB compressed, 2 GB unpacked |
| Template capture | Usually 1 to 10 minutes (snapshots the image and volume) |
| Registries | Pre-built images from public registries only; private code goes through repo builds |
Resources & plans
| What | Limit |
|---|
| Base allocation per agent | 2 GB RAM, 5 GB SSD |
| Self-serve ceilings per agent | 8 GB RAM, 100 GB SSD (flat add-on prices) |
| Included agents | Free 3 · Starter 20 · Growth 100 · Scale 500 (extras are flat per-agent prices) |
Sizing details in Env vars & sizing, prices in Billing & plans.
HTTP errors
| Status | Meaning |
|---|
| 401 | Missing, invalid, revoked, or expired API key |
| 402 | Plan limit reached, or an add-on needs a paid plan |
| 403 | API key lacks the required scope for this endpoint |
| 404 | No such agent, or it belongs to a different account |
| 409 | Conflict: agent name taken, deploy already in progress, or a file-move destination exists |
| 429 | Rate limited; back off and retry |
The SDKs raise these as typed errors (SDK error classes); the CLI maps them to exit codes (CLI exit codes).
