# Vercel Sandbox 2.0.0 - Product: Vercel Sandbox (https://whatsnew.fyi/product/vercel-sandbox) - Vendor: Vercel - Date: 2026-05-22 - Version: 2.0.0 - Original notes: https://github.com/vercel/sandbox/releases/tag/%40vercel/sandbox%402.0.0 - Permalink: https://whatsnew.fyi/product/vercel-sandbox/releases/2.0.0 What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog. Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'. --- - **added** — Introduce named and long-lived sandboxes - **added** — Add L7 request matchers and forward URLs support to network policy rules - **added** — Support pagination (CLI and SDK) when listing sandboxes, snapshots, sessions - **added** — Add `defineSandboxProxy` helper in `@vercel/sandbox/proxy` to easily implement network policies forwarding rules - **added** — Support keepLastSnapshots feature for CLI and SDK - **added** — Add sandbox port replacement support through `update` - **added** — Support default snapshot expiration for persistent sandboxes - **added** — Support a new method: Sandbox.getOrCreate() - **added** — Move to cursor pagination with new sortBy parameter for lists and new statusUpdatedAt filter - **added** — Add `Sandbox.fork(...)` to the SDK and `sandbox fork ` to the CLI for forking an existing sandbox into a new one - **added** — Support new onResume parameter in Sandbox.create and Sandbox.get - **added** — Support snapshot tree pagination - **added** — Add support for tags - **added** — Add Node 26 support - **added** — Add support for patch + delete v2 endpoints for named sandboxes - **changed** — Rename sandbox to session, namedSandbox to sandbox - **changed** — Refactor the sandbox update and deprecate old network-policy update - **changed** — Rename snapshotOnShutdown to persistent - **changed** — Automatically scale memory to vcpu when updating - **changed** — Remove support for blocking parameter in .stop() and default to always blocking - **changed** — Lists now unwrap the json and return the items and pagination fields directly - **fixed** — Fix an 422 error when trying to resume a sandbox after snapshotting - **fixed** — Fix `readFile` writing the API error JSON into the destination when the file response is not an octet-stream - **fixed** — Fix bug where the first ssh connection hang - **fixed** — Fix JsDocs, messages and double-error message bug - **changed** — Support updating current-snapshot-id of an existing sandbox ###### Major Changes - Introduce named and long-lived sandboxes ([#177](https://github.com/vercel/sandbox/pull/177)) ###### Minor Changes - Add L7 request matchers and forward URLs support to network policy rules. ([#177](https://github.com/vercel/sandbox/pull/177)) - Support pagination (CLI and SDK) when listing sandboxes, snapshots, sessions ([#177](https://github.com/vercel/sandbox/pull/177)) - Add `defineSandboxProxy` helper in `@vercel/sandbox/proxy` to easily implement network policies forwarding rules ([#188](https://github.com/vercel/sandbox/pull/188)) - Rename sandbox to session, namedSandbox to sandbox ([#177](https://github.com/vercel/sandbox/pull/177)) - Support keepLastSnapshots feature for CLI and SDK ([#193](https://github.com/vercel/sandbox/pull/193)) - Add sandbox port replacement support through `update`. ([#177](https://github.com/vercel/sandbox/pull/177)) - Support default snapshot expiration for persistent sandboxes ([#177](https://github.com/vercel/sandbox/pull/177)) - Refactor the sandbox update and deprecate old network-policy update ([#177](https://github.com/vercel/sandbox/pull/177)) - Support a new method: Sandbox.getOrCreate() ([#177](https://github.com/vercel/sandbox/pull/177)) - Rename snapshotOnShutdown to persistent ([#177](https://github.com/vercel/sandbox/pull/177)) - Automatically scale memory to vcpu when updating ([#177](https://github.com/vercel/sandbox/pull/177)) - Move to cursor pagination. Support new sortyBy parameter for lists. Support new statusUpdatedAt filter ([#177](https://github.com/vercel/sandbox/pull/177)) - Add `Sandbox.fork(...)` to the SDK and `sandbox fork ` to the CLI for forking an existing sandbox into a new one. ([#205](https://github.com/vercel/sandbox/pull/205)) - Remove support for blocking parameter in .stop() and default to always blocking. Improve CLI output when stopping a sandbox. ([#177](https://github.com/vercel/sandbox/pull/177)) - Lists now unwrap the json and return the items and pagination fields directly ([#177](https://github.com/vercel/sandbox/pull/177)) - Support new onResume parameter in Sandbox.create and Sandbox.get ([#177](https://github.com/vercel/sandbox/pull/177)) - Support snapshot tree pagination ([#191](https://github.com/vercel/sandbox/pull/191)) ###### Patch Changes - Add support for tags ([#177](https://github.com/vercel/sandbox/pull/177)) - Fix an 422 error when trying to resume a sandbox after snapshotting ([#177](https://github.com/vercel/sandbox/pull/177)) - Add Node 26 support. ([#177](https://github.com/vercel/sandbox/pull/177)) - Add support for patch + delete v2 endpoints for named sandboxes. ([#177](https://github.com/vercel/sandbox/pull/177)) - Fix `readFile` writing the API error JSON into the destination when the file response is not an octet-stream. The SDK now rejects any non-`application/octet-stream` response (including 2xx with a JSON error body) instead of piping it verbatim to the caller's stream. ([#202](https://github.com/vercel/sandbox/pull/202)) - Fix bug where the first ssh connection hang ([#177](https://github.com/vercel/sandbox/pull/177)) - Support updading current-snapshot-id of an existing sandbox ([#177](https://github.com/vercel/sandbox/pull/177)) - Fix JsDocs, messages and double-error message bug ([#177](https://github.com/vercel/sandbox/pull/177))