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

# Pause and resume a sandbox

> Pause and resume a sandbox to preserve machine state, reconnect with funding, and understand retained storage.

Pause and resume a sandbox to keep its memory and files without running compute. Resume it to continue from retained state.

## Pause and resume

```bash theme={null}
bead pause ID
bead inspect ID
bead resume ID
bead inspect ID
```

Wait for the state transition before sending work. A pause keeps a checkpoint; it does not delete the machine. Restores keep the same CPU and memory bounds.

Persistent machines pause after their [idle timeout](https://docs.bead.run/run-work/lifetime.md) and wake on funded access through exec, files, desktop, or application HTTP. Temporary machines still have a deletion timeout; pausing does not turn them into indefinite retained workspaces.

## Storage and funding

Paused machines pay for retained storage only. When a persistent machine cannot fund renewal, inspect its credit grace deadline and warnings. Top up before that deadline to keep it resumable. After the deadline the machine is deleted.

Use [prepaid credit](https://docs.bead.run/platform/prepaid-credit.md) for the funding model and `GET /v1/pricing` for current rates.

## Check recovery state

A failed capture can preserve the source machine. Read `preservation.message`, `operationID`, `recovered`, and `nextAction` from machine detail.

If `recovered` is true and `nextAction` is `resume_or_delete_source`, choose resume or delete according to your task. If recovery is still pending, inspect status before another capture attempt. `billing: platform` identifies a source whose tenant billing is paused for the failed operation.

Lifecycle changes retire old desktop links and human control sessions. Open a new [watch link](https://docs.bead.run/agents/watch-takeover.md) after resuming.

## Delete when finished

```bash theme={null}
bead delete ID
```

Deletion retires the machine. Save a reusable [snapshot](https://docs.bead.run/snapshots/overview.md) or download required [files](https://docs.bead.run/connect/files.md) first.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.