feat: snapshots

[dobrac]

Summary

Adds snapshot functionality to the SDK for creating persistent sandbox state that can be used to spawn new sandboxes.

Usage

JavaScript / TypeScript

// Create a snapshot from a running sandbox
const snapshot = await sandbox.createSnapshot()

// Or by sandbox ID
const snapshot = await Sandbox.createSnapshot(sandboxId)

// Create new sandbox from snapshot
const newSandbox = await Sandbox.create(snapshot.snapshotId)

// List snapshots
for await (const s of Sandbox.listSnapshots()) {
  console.log(s.snapshotId)
}

// Delete snapshot
await Sandbox.deleteSnapshot(snapshot.snapshotId)

Python (sync)

# Create a snapshot from a running sandbox
snapshot = sandbox.create_snapshot()

# Or by sandbox ID
snapshot = Sandbox.create_snapshot(sandbox_id)

# Create new sandbox from snapshot
new_sandbox = Sandbox.create(snapshot.snapshot_id)

# List snapshots
paginator = Sandbox.list_snapshots()
while paginator.has_next:
    snapshots = paginator.next_items()

# Delete snapshot
Sandbox.delete_snapshot(snapshot.snapshot_id)

Python (async)

# Create a snapshot from a running sandbox
snapshot = await sandbox.create_snapshot()

# Or by sandbox ID
snapshot = await AsyncSandbox.create_snapshot(sandbox_id)

# Create new sandbox from snapshot
new_sandbox = await AsyncSandbox.create(snapshot.snapshot_id)

# List snapshots
paginator = AsyncSandbox.list_snapshots()
while paginator.has_next:
    snapshots = await paginator.next_items()

# Delete snapshot
await AsyncSandbox.delete_snapshot(snapshot.snapshot_id)

API

JS SDK

• sandbox.createSnapshot() - Create snapshot from current sandbox
• Sandbox.createSnapshot(sandboxId) - Create snapshot by sandbox ID
• Sandbox.listSnapshots() - List all snapshots (paginated, async iterable)
• Sandbox.deleteSnapshot(snapshotId) - Delete a snapshot

Python SDK

• sandbox.create_snapshot() / Sandbox.create_snapshot(sandbox_id) - Create snapshot
• Sandbox.list_snapshots(sandbox_id=None) - List snapshots (paginated)
• Sandbox.delete_snapshot(snapshot_id) - Delete a snapshot
• Async variants on AsyncSandbox with the same signatures

---

Note

Medium Risk
Introduces new API surface and refactors pagination used by existing list calls, so regressions could affect listing behavior and snapshot lifecycle operations despite being additive overall.

Overview
Adds persistent sandbox snapshots to both SDKs: create a snapshot from a sandbox, list snapshots (optionally filtered by source sandbox), and delete snapshots (implemented via template deletion).

Updates the OpenAPI spec and generated clients to include /sandboxes/{sandboxID}/snapshots and /snapshots, introduces /v2/sandboxes/{sandboxID}/logs while deprecating the old logs route, and extends sandbox schemas with autoResume and volumeMounts plus new TemplateTag and volume-related schemas/endpoints. JS pagination was refactored to a shared BasePaginator, and new integration tests cover snapshot flows in JS and Python (sync/async).

^{Written by Cursor Bugbot for commit 3fd6132. This will update automatically on new commits. Configure here.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 3fd6132

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
e2b	Minor
@e2b/python-sdk	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Package Artifacts

Built from 784691b. Download artifacts from this workflow run.

JS SDK (e2b@2.12.2-feat-snapshots.0):

npm install ./e2b-2.12.2-feat-snapshots.0.tgz

CLI (@e2b/cli@2.7.2-feat-snapshots.0):

npm install ./e2b-cli-2.7.2-feat-snapshots.0.tgz

Python SDK (e2b==2.13.3+feat-snapshots):

pip install ./e2b-2.13.3+feat.snapshots-py3-none-any.whl

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f1206f378c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[ValentaTomas]

Left a note in one of the bot notes, but otherwise lgtm.

[mishushakov]

I'd like to ask to remove the AsyncIterableIterator from JS version. Use res.response.status for checking the status code (not res.error). Throw API Error/Pagination Error, instead of Sandbox error. In tests things like filename/contents and env vars should be accessed via env variables to avoid duplication.