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

# smolvm sandbox delete

> Use smolvm sandbox delete to remove one sandbox or clean up every sandbox on the host with a confirmation step.

`smolvm sandbox delete` removes sandboxes and releases their stored resources. Use it for normal cleanup after a workflow, or with `--all` when you want to clear every sandbox on the host.

## Synopsis

```bash theme={null}
smolvm sandbox delete <sandbox...> [OPTIONS]
smolvm sandbox delete --all [OPTIONS]
```

## Arguments

<ParamField path="sandbox..." type="string">
  One or more sandbox names or IDs to delete.
</ParamField>

## Options

<ParamField path="--all" type="flag">
  Delete every sandbox on the host.
</ParamField>

<ParamField path="--force" type="flag">
  Skip the confirmation prompt for `--all`. Required for `--all --json`.
</ParamField>

<ParamField path="--dry-run" type="flag">
  Show what would be deleted without deleting anything.
</ParamField>

<ParamField path="--json" type="flag">
  Print a JSON envelope instead of formatted text.
</ParamField>

<Warning>
  `smolvm sandbox delete --all --force` deletes every sandbox on the host. Use `--dry-run` first when you are unsure.
</Warning>

## Examples

### Delete one sandbox

```bash theme={null}
smolvm sandbox delete my-sandbox
```

### Delete several sandboxes

```bash theme={null}
smolvm sandbox delete test-a test-b old-agent
```

### Preview full cleanup

```bash theme={null}
smolvm sandbox delete --all --dry-run
```

### Delete every sandbox

```bash theme={null}
smolvm sandbox delete --all --force
```

### Use JSON in automation

```bash theme={null}
smolvm sandbox delete --all --force --json
```

## What gets cleaned up

For each target, SmolVM stops the sandbox if needed, removes its runtime state, releases network resources, and deletes the per-sandbox disk state it owns.

## Related commands

* [`smolvm sandbox list`](/smolvm/cli/list) - Review targets before deleting
* [`smolvm sandbox stop`](/smolvm/cli/stop) - Stop without deleting
* [`smolvm prune`](/smolvm/cli/prune) - Remove old image caches