Skip to main content
GET
List Snapshots
Returns every snapshot recorded for this sandbox — periodic, pause-induced, and manual — ordered by created_at descending. Ownership is enforced: the caller must be the owner of the sandbox for any snapshot metadata to be returned.

Path Parameters

string
required
The sandbox identifier. Format: sbx-<8 chars>.

Response

Snapshot[]
Array of snapshot objects, newest first.

Snapshot object

string
Unique snapshot identifier.
string
The sandbox this snapshot belongs to.
string
How this snapshot was created: "pause", "manual", or "periodic". "periodic" is deprecated — timer-based snapshots are no longer taken, so only rows recorded earlier still carry it.
string
Blob store key for the memory image.
string
Blob store key for the sandbox VM state.
integer | null
Logical size of the guest’s memory image in bytes, when recorded. This is the VM’s RAM size, not the storage it occupies — snapshots are compressed before they are stored, typically by 10–80x. Use the *_stored_bytes fields below for actual storage footprint.
integer | null
Bytes actually stored for the memory image, after compression. null for snapshots taken before stored-byte accounting existed.
integer | null
Bytes actually stored for the VM state, after compression.
integer | null
Bytes actually stored for the disk overlay, after compression. The overlay is copy-on-write, so this reflects only what the sandbox wrote — not its provisioned disk size.
string
UTC timestamp when the snapshot was created.

Example

Response

Error Responses