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

# webbox save-webbox-snapshot

> Save Web Box as Snapshot

Saves a running Web Box's app and current state as a Web Box Snapshot, ready when the response returns. The Web Box keeps running, and a paused one is woken. Web Boxes created from the Snapshot start with the saved state instead of a new workspace, so they refuse include\_sample\_data. The Snapshot outlives the Web Box. A starting Web Box returns 409 webbox\_starting; a stopping or stopped one returns 409 webbox\_stopped; one whose runtime cannot save its state returns 409 webbox\_rebuild\_required.

```bash theme={null}
continuous webbox save-webbox-snapshot [flags]
```

Alias: `sws`

## Examples

Replace `<id>` with the resource ID from your response before you run the command.

```bash theme={null}
continuous webbox save-webbox-snapshot --id <id>
```

## Flags

**--body** `string`

Request body as JSON (alternative to individual flags). Can also be provided via stdin.

**--id** `string` *required*

ID of the Box to save.

**--idempotency-key** `string`

Optional key for retrying this save safely. A retry with the same key and request returns the Snapshot the first save created. The same key with a different request returns 409 idempotency\_conflict.

**--metadata, -m** `string`

Customer JSON metadata, up to 16 KiB and 64 nesting levels.

**--name, -n** `string`

Name for the Snapshot. Omission generates a name.

Global flags apply to every command. See [Global flags](https://docs.continuouslabs.ai/cli/global-flags.md).


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