> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Sandboxes

A sandbox is an isolated computer that runs untrusted code. Agent Sandboxes is the platform that composes, controls, and hosts sandboxes at scale.

> [!WARNING]
>
> **Beta.** Agent Sandboxes is in beta.

## Introduction

The [Quick Start](https://developers.telnyx.com/docs/edge-compute/sandboxes/quick-start.md) gets code running in a sandbox and reachable on a public URL. [Architecture](https://developers.telnyx.com/docs/edge-compute/sandboxes/architecture.md) dives into the separation of the control plane, which acts **on** a sandbox, and the data plane, which acts **in** it. [Authentication](https://developers.telnyx.com/docs/edge-compute/sandboxes/authentication.md) covers the credential each plane requires. [Beta Limitations](https://developers.telnyx.com/docs/edge-compute/sandboxes/beta-limitations.md) 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](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/creation.md) and [Operations](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/operations.md) cover creating, listing, reading, and updating sandboxes. [User-Controlled Lifecycle](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/user-controlled-lifecycle.md) and [Platform-Managed Lifecycle](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/platform-managed-lifecycle.md) cover how a sandbox moves between its states, by request and on its own. [Snapshots](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/snapshots.md) keep a running sandbox's state for new sandboxes to start from, and [Network Limits](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/network-limits.md) control where a sandbox connects. [Composition](https://developers.telnyx.com/docs/edge-compute/sandboxes/composition.md) details the composability of sandboxes. [Linux](https://developers.telnyx.com/docs/edge-compute/sandboxes/linux.md) is the sandbox type available today.

## Platform Properties

[Isolation](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform-properties/isolation.md), [Persistence](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform-properties/persistence.md), [Scale](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform-properties/scale.md), and [Regions](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform-properties/regions.md) 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](https://developers.telnyx.com/docs/edge-compute/sandboxes/organization-resources.md) 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](https://developers.telnyx.com/docs/edge-compute/sandboxes/organization-resources/templates.md) start a sandbox with its server already listening, and [Secrets](https://developers.telnyx.com/docs/edge-compute/sandboxes/organization-resources/secrets.md) 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](https://developers.telnyx.com/docs/edge-compute/sandboxes/data-plane-operations/execs.md), reaches the sandbox's [Main Command](https://developers.telnyx.com/docs/edge-compute/sandboxes/data-plane-operations/main-command.md), and moves [Files](https://developers.telnyx.com/docs/edge-compute/sandboxes/data-plane-operations/files.md). [Metrics](https://developers.telnyx.com/docs/edge-compute/sandboxes/data-plane-operations/metrics.md) and [Lifecycle Events](https://developers.telnyx.com/docs/edge-compute/sandboxes/data-plane-operations/lifecycle-events.md) record each sandbox's resource use and state changes.

## Out-of-Band Access

[Ports](https://developers.telnyx.com/docs/edge-compute/sandboxes/out-of-band-access/ports.md) 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](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform/limits.md) lists every product limit and retention period. [Billing](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform/billing.md) explains resource usage, account information, and cleanup. [Errors](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform/errors.md) lists every error code the API returns.
