Skip to main content
POST
Save a named snapshot

Authorizations

Authorization
string
header
required

Boat bearer token in the form boat_.... Service API keys authenticate sandbox operations.

Body

application/json
sandboxId
string
required

The sandbox whose current state to freeze.

name
string
required

Name to save under. 1-63 lowercase letters, digits, or dashes, starting with a letter or digit. Reusing one of your existing names replaces that snapshot's artifact. latest, tree, pull, rm, save, current, self, and new are reserved.

Pattern: ^[a-z0-9][a-z0-9-]{0,62}$

Response

Save accepted and running in the background.

ok
boolean
required
Example:

true

type
string
required

Stable success envelope discriminator added by v1.

Allowed value: "snapshot.named.saving"
status
string
required
Allowed value: "saving"
snapshot
object
required

A named snapshot: a frozen copy of a sandbox's disk at one moment, saved under a name you pick. Independent of the source sandbox's later life: the sandbox can change, stop, or be deleted and the named snapshot still deploys. Named snapshots never expire; re-saving a name replaces its artifact.