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

# basecut snapshot delete

> Delete a snapshot by reference

Delete a snapshot by reference.

## Usage

```bash theme={null}
basecut snapshot delete <snapshot-ref> [flags]
```

## Arguments

| Argument         | Description                                                                             |
| ---------------- | --------------------------------------------------------------------------------------- |
| `<snapshot-ref>` | Snapshot identifier. Supported forms: UUID, `name:tag`, or `name` (resolves to latest). |

## Flags

| Flag               | Default     | Description                      |
| ------------------ | ----------- | -------------------------------- |
| `--yes, -y`        | `false`     | Skip confirmation prompt.        |
| `--profile <name>` | `default`   | Credential profile for API auth. |
| `--api-key <key>`  | env/profile | API key override.                |

## Examples

```bash theme={null}
# Delete by UUID (with prompt)
basecut snapshot delete 550e8400-e29b-41d4-a716-446655440000

# Delete by ref without prompt
basecut snapshot delete dev-seed:latest --yes
```

## Notes

* Snapshot deletion is currently a **metadata soft-delete**.
* Underlying storage objects are not automatically removed by this command.