> ## 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.

# Operations

A sandbox is listed, read, and updated through these operations. None of them moves it between its [states](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/user-controlled-lifecycle.md#states).

## List

`GET /sandbox` lists sandboxes, newest first, 20 per page and at most 100. The filters are `name`, `state`, which repeats, `tag[<key>]`, and `swarm`. Without `state`, terminated sandboxes are omitted, and they stay readable for at least 30 days.

The control plane lists every region's sandboxes, and a region's data plane lists its own. See [Regions](https://developers.telnyx.com/docs/edge-compute/sandboxes/platform-properties/regions.md#listing-across-regions). `telnyx-edge sandbox-cpu list` filters by `--name`, `--state`, and `--region`.

## Read

`GET /sandbox/{id}` returns one sandbox. A sandbox of another organization is `404`. The response below shows a few of its fields.

```json Output theme={null}
{
  "data": {
    "id": "sb-us-east-1-0193c4d2-7f1a-7c2e-9d4b-5a6e8f0c1b2d",
    "region": "us-east-1",
    "name": "run-42",
    "tags": { "task": "data-cleanup" },
    "state": "running",
    "cpu": 2,
    "memory_mib": 2048,
    ...
  }
}
```

The object carries the sandbox's [parts](https://developers.telnyx.com/docs/edge-compute/sandboxes/composition.md#parts), its [state](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/user-controlled-lifecycle.md#states), and its [lifetime](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/platform-managed-lifecycle.md). `env` and `rules` keep their markers, never secret values, and `registry_secret` is never returned. `telnyx-edge sandbox-cpu get` reads one sandbox by ID or name, as a table or as JSON with `--json`.

## Update

`PATCH /sandbox/{id}` replaces the whole tag set with `{"tags": {...}}`, and `{}` clears it. An update changes tags only, and is accepted on a terminated sandbox. The outbound policy and the timeout have their own requests, [`/network`](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/network-limits) and [`/timeout`](https://developers.telnyx.com/docs/edge-compute/sandboxes/common-control-plane/platform-managed-lifecycle#timeout).
