Skip to main content
GET
/
sandboxes
/
{sandbox_id}
/
snapshots
List Snapshots
curl --request GET \
  --url https://api.declaw.ai/sandboxes/{sandbox_id}/snapshots \
  --header 'X-API-Key: <api-key>'
{
  "snapshots": [
    {}
  ],
  "snapshot_id": "<string>",
  "sandbox_id": "<string>",
  "source": "<string>",
  "mem_blob_key": "<string>",
  "vmstate_blob_key": "<string>",
  "mem_size_bytes": {},
  "created_at": "<string>"
}
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

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

​
Response

​
snapshots
Snapshot[]
Array of snapshot objects, newest first.

​
Snapshot object

​
snapshot_id
string
Unique snapshot identifier.
​
sandbox_id
string
The sandbox this snapshot belongs to.
​
source
string
How this snapshot was created: "periodic", "pause", or "manual".
​
mem_blob_key
string
Blob store key for the memory image.
​
vmstate_blob_key
string
Blob store key for the Firecracker VM state.
​
mem_size_bytes
integer | null
Size of the memory image in bytes, when recorded.
​
created_at
string
UTC timestamp when the snapshot was created.

​
Example

curl "https://api.declaw.ai/sandboxes/sbx-a1b2c3d4/snapshots" \
  -H "X-API-Key: YOUR_API_KEY"
Response
{
  "snapshots": [
    {
      "snapshot_id": "snap-a1b2c3d4",
      "sandbox_id": "sbx-a1b2c3d4",
      "source": "manual",
      "mem_blob_key": "snapshots/.../mem",
      "vmstate_blob_key": "snapshots/.../state",
      "mem_size_bytes": 268435456,
      "created_at": "2026-04-14T10:30:00Z"
    }
  ]
}

​
Error Responses

StatusCause
401Missing or invalid API key
404Sandbox not found
500Internal error listing snapshots