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


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