Skip to main content
A sandbox is an isolated computer that runs untrusted code. Agent Sandboxes is the platform that composes, controls, and hosts sandboxes at scale.
Beta. Agent Sandboxes is in beta.

Introduction

The Quick Start gets code running in a sandbox and reachable on a public URL. Architecture dives into the separation of the control plane, which acts on a sandbox, and the data plane, which acts in it. Authentication covers the credential each plane requires. Beta Limitations lists what the beta does not do yet.

Runtime

Every sandbox is created and managed through the same common control plane, whatever its runtime, from the API or the telnyx-edge CLI. Creation and Operations cover creating, listing, reading, and updating sandboxes. User-Controlled Lifecycle and Platform-Managed Lifecycle cover how a sandbox moves between its states, by request and on its own. Snapshots keep a running sandbox’s state for new sandboxes to start from, and Network Limits control where a sandbox connects. Composition details the composability of sandboxes. Linux is the sandbox type available today.

Platform Properties

Isolation, Persistence, Scale, and Regions explain the properties every sandbox has. They cover what separates a sandbox from the host and from other sandboxes, what it keeps across a pause, a snapshot, or a fork, how many sandboxes run at once, and where a sandbox runs.

Organization Resources

Organization resources belong to the organization, not to any one sandbox. They sit beside the sandbox resource rather than under a sandbox ID, and sandboxes use them. Templates start a sandbox with its server already listening, and Secrets let code in a sandbox use credentials that the sandbox never holds.

Data Plane Operations

An agent works inside a sandbox on every turn through the data plane. It runs commands as Execs, reaches the sandbox’s Main Command, and moves Files. Metrics and Lifecycle Events record each sandbox’s resource use and state changes.

Out-of-Band Access

Ports put any HTTP or WebSocket server in a sandbox on its own public URL, reached outside the API by browsers, services, and other agents.

Platform

Limits lists every product limit and retention period. Billing explains resource usage, account information, and cleanup. Errors lists every error code the API returns.