Snapshots

Snapshots capture the full state of a running sandbox — filesystem, memory, and running processes. Use them to save work mid-session and restore it later in a new sandbox. Snapshots are independent of sandbox lifecycle — once captured, the artifact persists after the source sandbox is terminated. This means you can snapshot an ephemeral sandbox before it ends, then restore that state into a new sandbox much later.

Creating a Snapshot

CLI
Python
TypeScript
HTTP

tl sbx snapshot <sandbox-id>
tl sbx snapshot <sandbox-id> --timeout 600

from tensorlake.sandbox import SandboxClient

client = SandboxClient()
sandbox = client.create_and_connect()
sandbox.run("pip", ["install", "numpy", "pandas", "--user", "--break-system-packages"])
sandbox.run("python", ["-c", "import pandas as pd; pd.DataFrame({'a': [1,2,3]}).to_csv('/data/output.csv')"])

snapshot = client.snapshot_and_wait(sandbox.sandbox_id)
print(snapshot.snapshot_id)

const sandbox = await client.createAndConnect();

await sandbox.run("pip", {
  args: [
    "install",
    "numpy",
    "pandas",
    "--user",
    "--break-system-packages",
  ],
});
await sandbox.run("python", {
  args: [
    "-c",
    "import pandas as pd; pd.DataFrame({'a': [1,2,3]}).to_csv('/data/output.csv')",
  ],
});

const snapshot = await client.snapshotAndWait(sandbox.sandboxId);
console.log(snapshot.snapshotId);

curl -X POST https://api.tensorlake.ai/sandboxes/<sandbox-id>/snapshot \
  -H "Authorization: Bearer $TL_API_KEY"

Restoring from a Snapshot

Create a new sandbox from a snapshot. The new sandbox restores the captured filesystem, memory, and running processes exactly as they were — image, resources (CPUs, memory), entrypoint, and secrets all come from the snapshot and cannot be changed at restore time. If you need different resources, create a fresh sandbox instead of restoring.

CLI
Python
TypeScript
HTTP

tl sbx new --snapshot <snapshot-id>

restored = client.create_and_connect(snapshot_id=snapshot.snapshot_id)

result = restored.run("cat", ["/data/output.csv"])
print(result.stdout)

const restored = await client.createAndConnect({
  snapshotId: snapshot.snapshotId,
});

const result = await restored.run("cat", {
  args: ["/data/output.csv"],
});
console.log(result.stdout);

curl -X POST https://api.tensorlake.ai/sandboxes \
  -H "Authorization: Bearer $TL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"snapshot_id": "<snapshot-id>"}'

Clone a Sandbox

tl sbx clone creates a snapshot and immediately boots a new sandbox from it. The intermediate snapshot persists — it shows up in tl sbx snapshot ls and counts toward storage until you delete it with tl sbx snapshot rm <snapshot-id>.

CLI
Python
TypeScript
HTTP

tl sbx clone <sandbox-id>
tl sbx clone <sandbox-id> --timeout 600

Not yet exposed in the TypeScript SDK. Use the CLI for one-step clone workflows, or call snapshotAndWait() followed by createAndConnect() explicitly.

Managing Snapshots

List Snapshots

CLI
Python
TypeScript
HTTP

tl sbx snapshot ls

snapshots = client.list_snapshots()
for s in snapshots:
    print(f"{s.snapshot_id} | {s.status.value} | {s.size_bytes} bytes")

const snapshots = await client.listSnapshots();
for (const snapshot of snapshots) {
  console.log(
    `${snapshot.snapshotId} | ${snapshot.status} | ${snapshot.sizeBytes ?? 0} bytes`,
  );
}

curl https://api.tensorlake.ai/snapshots \
  -H "Authorization: Bearer $TL_API_KEY"

Get Snapshot Details

TypeScript
Python
HTTP
CLI

const info = await client.getSnapshot("snapshot-id");
console.log(info.status, info.baseImage, info.sizeBytes);

info = client.get_snapshot("snapshot_id")

curl https://api.tensorlake.ai/snapshots/<snapshot-id> \
  -H "Authorization: Bearer $TL_API_KEY"

Delete a Snapshot

CLI
TypeScript
Python
HTTP

tl sbx snapshot rm <snapshot-id>

await client.deleteSnapshot("snapshot-id");

client.delete_snapshot("snapshot_id")

curl -X DELETE https://api.tensorlake.ai/snapshots/<snapshot-id> \
  -H "Authorization: Bearer $TL_API_KEY"

`snapshot_and_wait` Parameters

Parameter	Type	Default	Description
`sandbox_id`	`str`	—	ID of the running sandbox to snapshot
`timeout`	`float`	`300`	Max seconds to wait for completion
`poll_interval`	`float`	`1.0`	Seconds between status polls

Overview

Guides

Use Cases

Creating a Snapshot

Restoring from a Snapshot

Clone a Sandbox

Managing Snapshots

List Snapshots

Get Snapshot Details

Delete a Snapshot

`snapshot_and_wait` Parameters

Overview

Guides

Use Cases

​Creating a Snapshot

​Restoring from a Snapshot

​Clone a Sandbox

​Managing Snapshots

​List Snapshots

​Get Snapshot Details

​Delete a Snapshot

​snapshot_and_wait Parameters

Creating a Snapshot

Restoring from a Snapshot

Clone a Sandbox

Managing Snapshots

List Snapshots

Get Snapshot Details

Delete a Snapshot

`snapshot_and_wait` Parameters