| Area | Limitation | Details |
|---|---|---|
| Regions | Sandboxes run in one region, us-east-1. More regions come as separate deployments. | Regions |
| Sizes | A sandbox has 1 or 2 vCPU, 256 to 4096 MiB of memory, an 8 GiB root disk, and a 16 GiB workspace disk. | Composition |
| Images | An image must offer linux/amd64, and its reference must name its registry host. | Linux |
| Quotas | An organization runs up to 20 sandboxes starting or running and holds up to 20 templates in each region, then 429 quota_exceeded. A fork’s source holds a slot, so the largest fork is 19 siblings. Four file transfers over 8 MiB run at once per organization on each API replica, then 503 with Retry-After. | Scale |
| Request rate | The control plane accepts 20 requests per second with one API key, then 429. The data plane sets no request rate limit. | Errors |
| Snapshots | A sandbox holds up to 3 snapshots, which are removed with it. Publishing a snapshot as a template is not available yet. | Snapshots |
| Templates | Tags that pin a create to one build are not available yet. | Templates |
| Warm pools | Warm pools of started sandboxes are not available yet. | Scale |
| Stop and archive | A sandbox pauses or terminates. There is no disk-only stop or archive tier, and a paused sandbox is kept 7 days. | Platform-Managed Lifecycle |
| Volumes | There are no persistent volumes. The workspace disk lives with the sandbox. | Persistence |
| GPU | A sandbox has no GPU. | Linux |
| Git and code tools | There are no git, code-run, or LSP routes. An exec runs those tools. | Execs |
| Ports | Every port is reachable at its URL, and the traffic token is the only access control. There are no signed URLs. | Ports |
| Access control | One organization API key and a 1-hour data-plane token authenticate every request. There are no scoped keys and no audit log. | Authentication |
| Webhooks | Lifecycle events are read by request. Webhooks are not available yet. | Lifecycle Events |
| Interfaces | The development telnyx-edge-dev sandbox-cpu CLI has commands for all operations in the current Sandbox OpenAPI contract; token minting is automatic. These commands are not yet in the public production CLI build. | Quick Start |
Beta Limitations
Agent Sandboxes is in beta. The current release does not do everything the platform will, and some of what it does has a constraint. Each row links to the page that explains it.
Was this page helpful?