feat(sdk): add name filter to snapshot list

[mishushakov]

Adds an optional name filter to Sandbox.listSnapshots() / Sandbox.list_snapshots(), mirroring the infra snapshots list endpoint (e2b-dev/infra#3184). The filter accepts a snapshot name or ID, optionally tag-qualified (e.g. "my-snapshot", "my-team/my-snapshot" or "my-snapshot:v1"); unknown names return an empty list. It's a flat top-level option alongside the existing sandboxId filter (non-breaking) and can be combined with it — the backend applies both with AND, matching the metadata+state behavior of Sandbox.list(). Applied equivalently across the OpenAPI spec, generated clients, and the JS + Python sync/async SDKs, with tests and a changeset.

Usage

// JS/TS
const paginator = Sandbox.listSnapshots({ name: 'my-snapshot' })
const snapshots = await paginator.nextItems()

// combine filters (snapshots from a sandbox matching a name)
Sandbox.listSnapshots({ sandboxId: 'sandbox-id', name: 'my-snapshot' })

# Python (sync)
paginator = Sandbox.list_snapshots(name="my-snapshot")
snapshots = paginator.next_items()

# Python (async)
paginator = AsyncSandbox.list_snapshots(name="my-snapshot")
snapshots = await paginator.next_items()

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 7b4420e

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

[cursor]

PR Summary

Low Risk
Additive, backward-compatible API and SDK surface; behavior depends on the already-deployed infra snapshots list endpoint.

Overview
Adds an optional name filter to snapshot listing so callers can target a snapshot by name or ID (including tag- or team-qualified forms like my-team/my-snapshot:v1), with unknown names returning an empty page instead of an error.

The GET /snapshots OpenAPI spec and generated clients gain a name query param; JS exposes it on SnapshotListOpts / SnapshotPaginator, and Python sync/async list_snapshots and paginators pass it through alongside the existing sandboxId / sandbox_id filter (both apply with AND). Integration tests cover match vs no-match; a changeset marks minor releases for e2b and @e2b/python-sdk.

^{Reviewed by Cursor Bugbot for commit 7b4420e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Package Artifacts

Built from b6eb227. Download artifacts from this workflow run.

JS SDK (e2b@2.31.1-yokohama.0):

npm install ./e2b-2.31.1-yokohama.0.tgz

CLI (@e2b/cli@2.13.1-yokohama.0):

npm install ./e2b-cli-2.13.1-yokohama.0.tgz

Python SDK (e2b==2.30.0+yokohama):

pip install ./e2b-2.30.0+yokohama-py3-none-any.whl

[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.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 1c65bc2. Configure here.}

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.