Skip to main content
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.
Alias: sws

​
Examples

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

​
Flags

​
string
Request body as JSON (alternative to individual flags). Can also be provided via stdin.
​
string
required
ID of the Box to save.
​
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.
​
string
Customer JSON metadata, up to 16 KiB and 64 nesting levels.
​
string
Name for the Snapshot. Omission generates a name.
Global flags apply to every command. See Global flags.