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

# squarecloud db snapshot

> Manages snapshots of your databases on Square Cloud.

Lists, creates and restores database snapshots. For `list` and `create`, the database ID is optional: the CLI resolves it from the argument, then falls back to an interactive picker.

```bash theme={null}
squarecloud db snapshot list
# Lists a summary of snapshots grouped by database.
```

```bash theme={null}
squarecloud db snapshot list <dbID>
# Lists every snapshot version for a specific database.
```

```bash theme={null}
squarecloud db snapshot create
# Uses an interactive picker to choose the database, then creates a snapshot and prints a download link.
```

```bash theme={null}
squarecloud db snapshot create <dbID> --download
# Creates a snapshot and downloads it to the local machine right after.
```

```bash theme={null}
squarecloud db snapshot restore <dbID> <snapshotID> <versionID>
# Restores the database from a specific snapshot version.
```

The `restore` subcommand is destructive: it replaces the database's current data with the snapshot's. It asks for `y/N` confirmation before proceeding; pass `-y`/`--yes` to skip the prompt.

`list` accepts `--json` for raw machine-readable output.

Use `squarecloud db snapshot --help` for more information about this command.