NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #1408 most downloaded on PyPI
E2B SDK that give agents cloud environments
Latest stable
2.64.0
Last release 9 days ago
13 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 57 of the last 60 stable releases
180 versions withdrawn
withdrawn after publishing
3 years old
377 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
### Minor Changes - e10958d: support for api h2
auto_pause/autoPause; use lifecycle={"on_timeout": "pause"} instead. A DeprecationWarning (Python) / console.warn (JS) is now emitted when the flag is setauto_resume=true while the resolved on_timeout is "kill" now raises InvalidArgumentException (Python) / InvalidArgumentError (JS)6a74c39: Require Node.js 22.19.0 or newer and depend on undici@^8 only (undici 7 is dropped).
SETTINGS_MAX_CONCURRENT_STREAMS and opens more connections when one is saturated.E2B_API_INFLIGHT_REQUESTS, E2B_ENVD_INFLIGHT_REQUESTS and E2B_ENVD_RPC_INFLIGHT_REQUESTS env vars. Concurrency is governed by undici's connection pools (E2B_API_CONNECTIONS, E2B_ENVD_RPC_CONNECTIONS).73a784d: Require Node.js 22 or newer (Node.js 20 is no longer supported).
Your coding agent can read these notes before it upgrades. Set up the MCP server →
eaf452a: add optional name parameter to createSnapshot and return snapshot names
undici ^7.29.1 → ^7.30.0 and optional undici8 8.10.2 → 8.11.2 (backported HTTP/2 WebSocket, decompression backpressure and aborted-request fixes), compare-versions ^6.1.0 → ^6.1.1 in e2b, and inquirer ^12.10.0 → ^12.11.1 in @e2b/cli.2ac5de2: Add signal: AbortSignal option to JS SDK methods to support cancelling in-flight requests. The signal can be passed to Sandbox.create, Sandbo
2ac5de2: Add signal: AbortSignal option to JS SDK methods to support cancelling in-flight requests. The signal can be passed to Sandbox.create, Sandbox.connect, sandbox.commands.run, sandbox.files.*, volume methods, and other request options. When the signal is aborted, the underlying fetch is aborted and the returned promise rejects with an AbortError.
SandboxPaginator.nextItems and SnapshotPaginator.nextItems now accept a SandboxApiOpts argument (including signal) — when provided, the per-call options override the connection options the paginator was constructed with for that single request.
Same change in the Python SDK: SandboxPaginator.next_items / SnapshotPaginator.next_items (sync and async) now accept **opts: ApiParams (e.g. api_key, domain, headers, request_timeout); when provided, the per-call options override the ones the paginator was constructed with.
e2b sandbox fork --count, JavaScript Sandbox.fork({ count }), and Python Sandbox.fork(count=...) reject a count outside 1–20 before the API call. Counts from 21 through 100 used to reach the API. Omitting count still leaves the field off the request so the API default applies.55e9e0e: resolve Dependabot security alerts: bump vulnerable transitive npm deps via pnpm overrides (postcss, vite, lodash, brace-expansion, picomatch…
2c995d4: added opt-in useOctetStream / use_octet_stream option to sandbox file write; default is now multipart/form-data regardless of envd version
useOctetStream / use_octet_stream option to sandbox file write; default is now multipart/form-data regardless of envd versioneaf452a: add optional name parameter to createSnapshot and return snapshot names
cf35f61: switch to application/octet-stream for file uploads
e2b sandbox fork command to fork a running sandbox into one or more new sandboxes6d7e72e: added volumes support to the SDKs
### Minor Changes - f7f1f29: Update SDK READMEs
e2b.toml in sandbox create, template delete and template publish/unpublish, and remove their --config and --path options. Templates must now be passed as an argument or picked interactively with -s. template migrate is unchanged and remains the only command that reads e2b.toml.e2b sandbox exec to the remote command instead of parsing them as CLI optionstar 7.5.22 and @bufbuild/protobuf 2.14.0 in the JS SDK, statuses 2.0.2, async-listen 3.1.0 and yup 1.7.1 in the CLI. No behavior change.e2b sandbox create --detach now prints only the sandbox ID to stdout; the dashboard inspect link and other informational output go to stderr so the ID is easily parseable (e.g. SBX=$(e2b sandbox create -d)).docs.e2b.dev instead of e2b.dev/docs. The docs site moved to its own subdomain and has no /docs path prefix there, so e2b.dev/docs serves a 308 to docs.e2b.dev/ and e2b.dev/docs/code-interpreting maps to docs.e2b.dev/code-interpreting. The UTM parameters are unchanged and survived the redirect, so this removes a redirect hop rather than fixing broken attribution.### Minor Changes - f7f1f29: Update SDK READMEs
e2b sandbox snapshot commands: create <sandboxID> (with optional --name) to create a snapshot from a sandbox, list [sandboxID] (with optional --name filter and --format json) to list snapshots, and delete <snapshotIDs...> to delete snapshots.Sandbox.list. The order option ('asc' / 'desc', default 'desc') sorts sandboxes by start time across the whole paginated dataset, and the query now supports startedAfter / started_after (inclusive lower bound on start time) and template (exact template ID or alias) filters, all applied server-side before pagination. The CLI e2b sandbox list command exposes these via --order, --started-after, and --template.7c8d298: adds network configs and lifecycle handling to info responses
48e9249: Bump @npmcli/package-json from ^5.2.1 to ^7.0.5, clearing the last npm warn deprecated glob@10.5.0 warning printed on every @e2b/cli install (@npmcli/package-json@5 pinned glob@10; 7.0.4 moved to glob@13). Together with the e2b glob bump, a fresh npm install @e2b/cli is now warning-free and drops from 183 to 145 packages.
@npmcli/package-json@7 requires Node ^20.17.0 || >=22.9.0, so the CLI's Node 22 floor moves from >=22 to >=22.9.0. Node 20 support is unchanged (>=20.18.1 <21). Only the PackageJson.load/create/update/save API used by e2b template init is touched, and it is unchanged across the bump.
fixMissing / fix_missing option to aptInstall / apt_install to support the --fix-missing flag in apt-get install710fae6: request_timeout applies to connect/pool/write
16c86d1: Support multiple asyncio loops
5417dd4: Rebuild the CLI so the bundled tar picks up 7.5.19+, fixing the node-tar denial-of-service vulnerabilities (the CLI bundles the SDK and its d…
tar picks up 7.5.19+, fixing the node-tar denial-of-service vulnerabilities (the CLI bundles the SDK and its dependencies into dist/index.js)ca85620: Add fixMissing / fix_missing option to aptInstall / apt_install to support the --fix-missing flag in apt-get install
fixMissing / fix_missing option to aptInstall / apt_install to support the --fix-missing flag in apt-get installteam fields in ~/.e2b/config.json to project: the config format version is bumped to 2 and teamName, teamId, and teamApiKey become projectName, projectId, and projectApiKey. Existing v1 configs keep working — they are converted to the new format in memory on read, and the file on disk is only rewritten in the new format when the config is persisted anyway (login, e2b auth configure, token refresh), so older CLI versions can still read it in the meantime. Unrecognized configs are no longer deleted; the CLI treats them as signed out and e2b auth login overwrites them. Tools that read the config file directly must handle the new field names. CLI output and flags are unchanged and still say "team".222105d: include .dot files in template file upload
getTags/get_tags method to list all tags for a templateThe --team flag keeps working but is hidden from help and prints a deprecation warning. The project ID can also be set via the new E2B_PROJECT_ID envi…
--team flag to --project on template list, template publish, template unpublish, and template delete. The --team flag keeps working but is hidden from help and prints a deprecation warning. The project ID can also be set via the new E2B_PROJECT_ID environment variable; E2B_TEAM_ID is still supported and is used when E2B_PROJECT_ID is not set.…and switch e2b sandbox pause to call the non-deprecated Sandbox.pause() instead of the deprecated Sandbox.betaPause() alias.
User-Agent header of every request with e2b-cli/<version> and the invoked command as e2b-cli-command/<command> (e.g. e2b-cli-command/sandbox.list) via ConnectionConfig.setIntegratione2b template create --memory-mb help text to reflect the real default of 1024 MB (was incorrectly stated as 512), and switch e2b sandbox pause to call the non-deprecated Sandbox.pause() instead of the deprecated Sandbox.betaPause() alias.Nothing published for this version
49367c8: Switch the build tooling from tsup to tsdown. The published artifacts are unchanged: the SDK still ships dist/index.js (CJS), dist/index.mjs
49367c8: Switch the build tooling from tsup to tsdown. The published artifacts are unchanged: the SDK still ships dist/index.js (CJS), dist/index.mjs (ESM) and dist/index.d.ts/dist/index.d.mts, and the CLI still ships an executable dist/index.js with its dist/templates.
engines.node for both packages is set to >=20.18.1 <21 || >=22 (Node 20.18.1+, or 22 and above — keeping the minimum required by undici while excluding the end-of-life Node 21 line).
Updated dependencies [e6c4e7e]
Updated dependencies [09e12b3]
Updated dependencies [49367c8]
2869feb: Add override options to e2b template migrate: --name/-n to override the generated template name, --cmd/-c for the start command, --ready-cmd
e2b template migrate: --name/-n to override the generated template name, --cmd/-c for the start command, --ready-cmd for the ready command, and --cpu-count / --memory-mb for sandbox resources. Each falls back to the value from the config file (e2b.toml) when not provided. --cpu-count and --memory-mb (on both migrate and create) now reject non-numeric values at parse time instead of silently becoming NaN. Template name validation is now shared across init, migrate and create and matches the server-side rule: names are trimmed and lowercased, must contain only letters, numbers, dashes and underscores, and are capped at 128 characters. init/migrate no longer wrongly reject names with leading/trailing dashes or underscores.e2b template migrate generating Python build scripts that fail to run as instructed. The generated build_dev.py / build_prod.py used a package-relative import (from .template import template) while the command instructs single-file execution (python build_dev.py), causing ImportError: attempted relative import with no known parent package. The scripts now use a runnable absolute import (from template import template).dockerfile-ast dependency from the CLI. The CLI never imported it directly — all Dockerfile parsing goes through the e2b SDK, which keeps its own dockerfile-ast dependency. No behavior change.getTags/get_tags method to list all tags for a templateConfig schema bumped to v1 with nested identity, oauth, and tokens sections. Old flat configs are deprecated and require re-login.
identity, oauth, and tokens sections. Old flat configs are deprecated and require re-login.726ced6: Fix duplicate logo on NPM/PyPI by switching to element.
<picture> element.f3e7f33: Tidy up SDK authentication and deprecate the access token in ConnectionConfig.
f3e7f33: Tidy up SDK authentication and deprecate the access token in ConnectionConfig.
accessToken (JS) / access_token (Python) option on ConnectionConfig. It still works exactly as before — when set (or via E2B_ACCESS_TOKEN), the Authorization: Bearer header is still sent — but you should pass custom auth through apiHeaders instead, e.g. new ConnectionConfig({ apiHeaders: { Authorization: 'Bearer <token>' } }).https://e2b.dev/dashboard?tab=keys). In JS this is controlled by a requireApiKey option (default true) so callers that authenticate differently — like the CLI hitting /teams with an access token — can opt out; in Python the API key is always required.requireAccessToken (JS) and require_access_token (Python). No caller ever set it to a non-default value, so behavior is unchanged./teams endpoint through apiHeaders instead of the deprecated option.ConnectionConfig: EnvdApiClient now owns its own accessToken field and sets the X-Access-Token header itself.0a5d524: Update package logos with theme-aware dark/light variants for GitHub.
Updated dependencies [f3e7f33]
Updated dependencies [0a5d524]
…requiring E2B_ACCESS_TOKEN. E2B_ACCESS_TOKEN is deprecated, so commands whose endpoints accept either credential now use the API key. This also unbloc…
e2b template list and e2b template create now authenticate with E2B_API_KEY instead of requiring E2B_ACCESS_TOKEN. E2B_ACCESS_TOKEN is deprecated, so commands whose endpoints accept either credential now use the API key. This also unblocks API-key-only environments (e.g. CI/CD) that previously could not create or list templates.Template.build() now accepts names in name:tag format (e.g., "my-template:v1.0")Template.assignTags() / Template.assign_tags() to assign tags to existing buildsTemplate.removeTags() / Template.remove_tags() to remove tagsf188891: Fully deprecate e2b template build (v1): command now only shows the deprecation notice and exits. Removed all v1 Docker build/push logic and…
e2b template build (v1): command now only shows the deprecation notice and exits. Removed all v1 Docker build/push logic and deleted buildWithProxy.ts.components['schemas'][...] instead of verbose paths[...] traversal for OpenAPI-generated type references.ensureAccessToken call from e2b template create: the command now relies solely on the API key for authentication.Template.build() now accepts names in name:tag format (e.g., "my-template:v1.0")Template.assignTags() / Template.assign_tags() to assign tags to existing buildsTemplate.removeTags() / Template.remove_tags() to remove tagsab906ad: fix:timestamp conversion for metric endpoints
e2b auth login crashing on headless machines where xdg-open is unavailable. The CLI now spawns the browser opener directly so it can catch the spawn ENOENT synchronously, prints the login URL so the user can open it manually, and suggests setting E2B_API_KEY when interactive login is not possible.31670f4: updates template alias error type
get_transport(config, http_version="1.1"), following the renamed argument in e2b 2.52.0 (now the minimum supported version).d8ef36d: Support for Template.aliasExists to check if template alias is available
E2B client to the Code Interpreter SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox (and AsyncSandbox in Python) together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.5aa1d24: Fix tmux rendering issues by adding UTF-8 locale environment variables (LANG, LC_ALL) to PTY creation. This fixes garbled Unicode and box-dra
logs.stdout, logs.stderr and OutputMessage.line hold raw chunks with newlines kept (join them with '' to rebuild the output), and that Result.png, Result.jpeg and Result.pdf are base64-encoded.readLines quadratic line reassembly when streaming long single-line outputs (e.g. base64 images, wide DataFrames, large JSON): decode and scan only each new chunk, accumulating line fragments in an array that is joined once per emitted line, instead of appending to and re-scanning a single string buffer on every chunk.OutputMessage.timestamp in the JS Code Interpreter to use the backend timestamp (Unix epoch in nanoseconds) sent with each stdout/stderr message, instead of the client clock (new Date().getTime() * 1000). The type is unchanged (number); this aligns the value with the documented contract and the Python SDK. Because nanosecond epoch values exceed Number.MAX_SAFE_INTEGER, the JS value is precise to a few hundred nanoseconds (documented on OutputMessage.timestamp).dcaca73: cli supports info command which is the equivilent of the getInfo
6a74c39: Require Node.js 22.19.0 or newer and depend on undici@^8 only (undici 7 is dropped).
SETTINGS_MAX_CONCURRENT_STREAMS and opens more connections when one is saturated.E2B_API_INFLIGHT_REQUESTS, E2B_ENVD_INFLIGHT_REQUESTS and E2B_ENVD_RPC_INFLIGHT_REQUESTS env vars. Concurrency is governed by undici's connection pools (E2B_API_CONNECTIONS, E2B_ENVD_RPC_CONNECTIONS).73a784d: Require Node.js 22 or newer (Node.js 20 is no longer supported).
b0ab7f7: Add implicit limit for sandbox list query to CLI
bcc6ea8: Add pause and resume commands to manage sandbox state.
pause and resume commands to manage sandbox state.
e2b sandbox pause <sandboxID> - pause a running sandboxe2b sandbox resume <sandboxID> - resume a paused sandboxE2B client to the Code Interpreter SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox (and AsyncSandbox in Python) together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.87ceec2: Implement closeStdin to allow piping commands into the CLI
470de91: fixes default context directory for windows paths
6b74009: add background template build options
23adc93: fix cache invalidation when calling .copy() on updated folder during the template build
e87576f: fix to_dockerfile env output syntax
urllib3>=2.8.0 so installs pick up the fixes for CVE-2026-97687 (HTTPS proxy TLS configuration ignored) and CVE-2026-97689 (unbounded chunk-size line buffering).631522d: Use v2 template update endpoint and display namespaced template name after publishing
secure option of Sandbox.create (still accepted, now ignored): every sandbox is created through the v2 API, which always secures envd access. allow_internet_access is no longer preset to True; when omitted, the API default applies.### Minor Changes - 4ebabfe: Add exec command
E2B client to the Desktop SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.6a74c39: Require Node.js 22.19.0 or newer and depend on undici@^8 only (undici 7 is dropped).
SETTINGS_MAX_CONCURRENT_STREAMS and opens more connections when one is saturated.E2B_API_INFLIGHT_REQUESTS, E2B_ENVD_INFLIGHT_REQUESTS and E2B_ENVD_RPC_INFLIGHT_REQUESTS env vars. Concurrency is governed by undici's connection pools (E2B_API_CONNECTIONS, E2B_ENVD_RPC_CONNECTIONS).73a784d: Require Node.js 22 or newer (Node.js 20 is no longer supported).
583c051: patch Fix tmux rendering issues by adding UTF-8 locale env vars to PTY
98d2c8c: Ensure that httpx transport is reused across calls by default
b65f190: add dependency notice to template migrate command
742a9ba: Update connect to only extend timeout
E2B client to the Desktop SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.de2a922: make --no-install-recommends optional in apt_install
d4619f6: fix from ubuntu default variant
12daca8: add custom mcp support
Nothing published for this version
ad194b4: rename e2b.toml and Dockerfile to e2b.toml.old and Dockerfile.old on migrate
1a51777: fix racecondition in mcp gateway
057f902: fixed --config option in e2b tpl publish and e2b tpl delete
c05c8c6: new build system v2 release
### Patch Changes - 7311427: added docstrings - 5943485: Add mcp auth
f122912: set correct Docker user workdir defaults
a01c237: add template build logs pretty output helper
1203ccb: Add experimental MCP functionality to beta
1203ccb: Add experimental MCP functionality to beta
### Patch Changes - f5cfa6d: Update node
b1e2701: fix template build files copy cache invalidation
e142c23: Set stdin to /dev/null for process.run by default
One column per quarter.