# Vercel Sandbox 3.1.0

- Product: Vercel Sandbox (https://whatsnew.fyi/product/vercel-sandbox)
- Vendor: Vercel
- Date: 2026-08-21
- Version: 3.1.0
- Original notes: https://github.com/vercel/sandbox/releases/tag/%40vercel/sandbox%403.1.0
- Permalink: https://whatsnew.fyi/product/vercel-sandbox/releases/3.1.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** — Add multi-region support with new region and failoverRegions options on sandbox create, fork, and update in SDK and matching flags in CLI commands
- **added** — Add failoverRegions getter on Sandbox and regions getter on Snapshot
- **added** — Show regions in sandbox ls, sessions list, snapshots list/get, sandbox config list, and create/fork summary
- **changed** — Sandbox.region and Sandbox.failoverRegions no longer return undefined and now report platform defaults (iad1 and []) when API omits fields, with types string and string[]
- **added** — Export DEFAULT_SANDBOX_REGION to make the default region readable
- **fixed** — Update defineSandboxProxy to limit the JWKS issuer cache size to prevent unbounded memory usage

###### Minor Changes

- Add multi-region support: ([#301](https://github.com/vercel/sandbox/pull/301))

  - New `region` and `failoverRegions` options on sandbox create, fork, and update (SDK), with matching flags on `sandbox create`, `fork`, `run`, `sh`, and the `sandbox config region` / `sandbox config failover-regions` commands (CLI).
  - New `failoverRegions` getter on `Sandbox` and `regions` getter on `Snapshot`.
  - Regions are now shown in `sandbox ls`, `sessions list`, `snapshots list`/`get`, `sandbox config list`, and the create/fork summary.

- `Sandbox.region` and `Sandbox.failoverRegions` no longer return `undefined`: the getters now report the platform defaults (`iad1` and `[]`) when the API omits the fields, so their types are `string` and `string[]`. The new `DEFAULT_SANDBOX_REGION` export makes the default region readable. ([#301](https://github.com/vercel/sandbox/pull/301))

###### Patch Changes

- Update `defineSandboxProxy` to limit the JWKS issuer cache size to prevent unbounded memory usage. ([#309](https://github.com/vercel/sandbox/pull/309))