Skip to content

armgit / E2B

Public Imported from GitHub
0

Open-source, secure environment with real-world tools for enterprise-grade agents.

[skip ci] Release new versions

github-actions[bot]3993a171893b
diff --git a/.changeset/cli-template-build-format.md b/.changeset/cli-template-build-format.md
deleted file mode 100644
index fe83a10dd..000000000
--- a/.changeset/cli-template-build-format.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'@e2b/cli': patch
----
-
-Update templates to use new `Template.build()` format
diff --git a/.changeset/template-versioning-tags.md b/.changeset/template-versioning-tags.md
deleted file mode 100644
index c0513a6b8..000000000
--- a/.changeset/template-versioning-tags.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-'e2b': minor
-'@e2b/python-sdk': minor
----
-
-Add template versioning with tags support
-
-- `Template.build()` now accepts names in `name:tag` format (e.g., `"my-template:v1.0"`)
-- New `Template.assignTags()` / `Template.assign_tags()` to assign tags to existing builds
-- New `Template.removeTags()` / `Template.remove_tags()` to remove tags
diff --git a/apps/web/package.json b/apps/web/package.json
index a7090fb63..ba49808b2 100644
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -42,7 +42,7 @@
"autoprefixer": "^10.4.7",
"class-variance-authority": "^0.7.0",
"clsx": "^1.2.1",
- "e2b": "^2.10.5",
+ "e2b": "^2.11.0",
"fast-glob": "^3.3.0",
"fast-xml-parser": "4.4.1",
"flexsearch": "^0.7.31",
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/auth/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/auth/page.mdx
new file mode 100644
index 000000000..2c82afa69
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/auth/page.mdx
@@ -0,0 +1,58 @@
+## e2b auth
+
+
+authentication commands
+
+### Usage
+
+```bash
+e2b auth [options] [command]
+```
+## e2b auth login
+
+
+log in to CLI
+
+### Usage
+
+```bash
+e2b auth login [options]
+```
+
+
+## e2b auth logout
+
+
+log out of CLI
+
+### Usage
+
+```bash
+e2b auth logout [options]
+```
+
+
+## e2b auth info
+
+
+get information about the current user
+
+### Usage
+
+```bash
+e2b auth info [options]
+```
+
+
+## e2b auth configure
+
+
+configure user
+
+### Usage
+
+```bash
+e2b auth configure [options]
+```
+
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/sandbox/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/sandbox/page.mdx
new file mode 100644
index 000000000..39a3014d7
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/sandbox/page.mdx
@@ -0,0 +1,155 @@
+## e2b sandbox
+
+
+work with sandboxes
+
+### Usage
+
+```bash
+e2b sandbox [options] [command]
+```
+## e2b sandbox connect
+
+
+connect terminal to already running sandbox
+
+### Usage
+
+```bash
+e2b sandbox connect [options] <sandboxID>
+```
+
+
+## e2b sandbox list
+
+
+list all sandboxes, by default it list only running ones
+
+### Usage
+
+```bash
+e2b sandbox list [options]
+```
+
+### Options
+
+
+ - `-s, --state <state>: filter by state, eg. running, paused. Defaults to running `
+ - `-m, --metadata <metadata>: filter by metadata, eg. key1=value1 `
+ - `-l, --limit <limit>: limit the number of sandboxes returned `
+ - `-f, --format <format>: output format, eg. json, pretty `
+
+
+## e2b sandbox kill
+
+
+kill sandbox
+
+### Usage
+
+```bash
+e2b sandbox kill [options] [sandboxIDs...]
+```
+
+### Options
+
+
+ - `-a, --all: kill all sandboxes `
+ - `-s, --state <state>: when used with -a/--all flag, filter by state, eg. running, paused. Defaults to running `
+ - `-m, --metadata <metadata>: when used with -a/--all flag, filter by metadata, eg. key1=value1 `
+
+
+## e2b sandbox create
+
+
+create sandbox and connect terminal to it
+
+### Usage
+
+```bash
+e2b sandbox create [options] [template]
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `--config <e2b-toml>: specify path to the E2B config toml. By default E2B tries to find ./e2b.toml in root directory. We recommend using the new build system (https://e2b.dev/docs/template/defining-template) that does not use config files. `
+
+
+## e2b sandbox spawn
+
+
+create sandbox and connect terminal to it
+
+### Usage
+
+```bash
+e2b sandbox spawn [options] [template]
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `--config <e2b-toml>: specify path to the E2B config toml. By default E2B tries to find ./e2b.toml in root directory. We recommend using the new build system (https://e2b.dev/docs/template/defining-template) that does not use config files. `
+
+
+## e2b sandbox logs
+
+
+show logs for sandbox
+
+### Usage
+
+```bash
+e2b sandbox logs [options] <sandboxID>
+```
+
+### Options
+
+
+ - `--level <level>: filter logs by level (DEBUG, INFO, WARN, ERROR). The logs with the higher levels will be also shown. [default: INFO]`
+ - `-f, --follow: keep streaming logs until the sandbox is closed `
+ - `--format <format>: specify format for printing logs (json, pretty) [default: pretty]`
+ - `--loggers [loggers]: filter logs by loggers. Specify multiple loggers by separating them with a comma. `
+
+
+## e2b sandbox metrics
+
+
+show metrics for sandbox
+
+### Usage
+
+```bash
+e2b sandbox metrics [options] <sandboxID>
+```
+
+### Options
+
+
+ - `-f, --follow: keep streaming metrics until the sandbox is closed `
+ - `--format <format>: specify format for printing metrics (json, pretty) [default: pretty]`
+
+
+## e2b sandbox exec
+
+
+execute a command in a running sandbox
+
+### Usage
+
+```bash
+e2b sandbox exec [options] <sandboxID> <command...>
+```
+
+### Options
+
+
+ - `-b, --background: run in background and return immediately `
+ - `-c, --cwd <dir>: working directory `
+ - `-u, --user <user>: run as specified user `
+ - `-e, --env <KEY=VALUE>: set environment variable (repeatable) [default: [object Object]]`
+
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/template/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/template/page.mdx
new file mode 100644
index 000000000..ec92020ed
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/cli/v2.5.1/template/page.mdx
@@ -0,0 +1,180 @@
+## e2b template
+
+
+manage sandbox templates
+
+### Usage
+
+```bash
+e2b template [options] [command]
+```
+## e2b template create
+
+
+build Dockerfile as a Sandbox template. This command reads a Dockerfile and builds it directly.
+
+### Usage
+
+```bash
+e2b template create [options] <template-name>
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `-d, --dockerfile <file>: specify path to Dockerfile. By default E2B tries to find e2b.Dockerfile or Dockerfile in root directory. `
+ - `-c, --cmd <start-command>: specify command that will be executed when the sandbox is started. `
+ - `--ready-cmd <ready-command>: specify command that will need to exit 0 for the template to be ready. `
+ - `--cpu-count <cpu-count>: specify the number of CPUs that will be used to run the sandbox. The default value is 2. `
+ - `--memory-mb <memory-mb>: specify the amount of memory in megabytes that will be used to run the sandbox. Must be an even number. The default value is 512. `
+ - `--no-cache: skip cache when building the template. `
+
+
+## e2b template build
+
+
+build sandbox template defined by ./e2b.Dockerfile or ./Dockerfile in root directory. By default the root directory is the current working directory. This command also creates e2b.toml config.
+
+### Usage
+
+```bash
+e2b template build [options] [template]
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `-d, --dockerfile <file>: specify path to Dockerfile. By default E2B tries to find e2b.Dockerfile or Dockerfile in root directory. `
+ - `-n, --name <template-name>: specify sandbox template name. You can use the template name to start the sandbox with SDK. The template name must be lowercase and contain only letters, numbers, dashes and underscores. `
+ - `-c, --cmd <start-command>: specify command that will be executed when the sandbox is started. `
+ - `--ready-cmd <ready-command>: specify command that will need to exit 0 for the template to be ready. `
+ - `-t, --team <team-id>: specify the team ID that the operation will be associated with. You can find team ID in the team settings in the E2B dashboard (https://e2b.dev/dashboard?tab=team). `
+ - `--config <e2b-toml>: specify path to the E2B config toml. By default E2B tries to find ./e2b.toml in root directory. We recommend using the new build system (https://e2b.dev/docs/template/defining-template) that does not use config files. `
+ - `--cpu-count <cpu-count>: specify the number of CPUs that will be used to run the sandbox. The default value is 2. `
+ - `--memory-mb <memory-mb>: specify the amount of memory in megabytes that will be used to run the sandbox. Must be an even number. The default value is 512. `
+ - `--build-arg <args...>: specify additional build arguments for the build command. The format should be <varname>=<value>. `
+ - `--no-cache: skip cache when building the template. `
+
+
+## e2b template list
+
+
+list sandbox templates
+
+### Usage
+
+```bash
+e2b template list [options]
+```
+
+### Options
+
+
+ - `-t, --team <team-id>: specify the team ID that the operation will be associated with. You can find team ID in the team settings in the E2B dashboard (https://e2b.dev/dashboard?tab=team). `
+ - `-f, --format <format>: output format, eg. json, pretty `
+
+
+## e2b template init
+
+
+initialize a new sandbox template using the SDK
+
+### Usage
+
+```bash
+e2b template init [options]
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `-n, --name <name>: template name (alias) `
+ - `-l, --language <language>: target language: typescript, python-sync, python-async `
+
+
+## e2b template delete
+
+
+delete sandbox template and e2b.toml config
+
+### Usage
+
+```bash
+e2b template delete [options] [template]
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `--config <e2b-toml>: specify path to the E2B config toml. By default E2B tries to find ./e2b.toml in root directory. We recommend using the new build system (https://e2b.dev/docs/template/defining-template) that does not use config files. `
+ - `-s, --select: select sandbox template from interactive list `
+ - `-t, --team <team-id>: specify the team ID that the operation will be associated with. You can find team ID in the team settings in the E2B dashboard (https://e2b.dev/dashboard?tab=team). `
+ - `-y, --yes: skip manual delete confirmation `
+
+
+## e2b template publish
+
+
+publish sandbox template
+
+### Usage
+
+```bash
+e2b template publish [options] [template]
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `--config <e2b-toml>: specify path to the E2B config toml. By default E2B tries to find ./e2b.toml in root directory. We recommend using the new build system (https://e2b.dev/docs/template/defining-template) that does not use config files. `
+ - `-s, --select: select sandbox template from interactive list `
+ - `-t, --team <team-id>: specify the team ID that the operation will be associated with. You can find team ID in the team settings in the E2B dashboard (https://e2b.dev/dashboard?tab=team). `
+ - `-y, --yes: skip manual publish confirmation `
+
+
+## e2b template unpublish
+
+
+unpublish sandbox template
+
+### Usage
+
+```bash
+e2b template unpublish [options] [template]
+```
+
+### Options
+
+
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+ - `--config <e2b-toml>: specify path to the E2B config toml. By default E2B tries to find ./e2b.toml in root directory. We recommend using the new build system (https://e2b.dev/docs/template/defining-template) that does not use config files. `
+ - `-s, --select: select sandbox template from interactive list `
+ - `-t, --team <team-id>: specify the team ID that the operation will be associated with. You can find team ID in the team settings in the E2B dashboard (https://e2b.dev/dashboard?tab=team). `
+ - `-y, --yes: skip manual unpublish confirmation `
+
+
+## e2b template migrate
+
+
+migrate e2b.Dockerfile and e2b.toml to new Template SDK format
+
+### Usage
+
+```bash
+e2b template migrate [options]
+```
+
+### Options
+
+
+ - `-d, --dockerfile <file>: specify path to Dockerfile. Defaults to e2b.Dockerfile `
+ - `--config <e2b-toml>: specify path to the E2B config toml. By default E2B tries to find ./e2b.toml in root directory. We recommend using the new build system (https://e2b.dev/docs/template/defining-template) that does not use config files. `
+ - `-l, --language <language>: specify target language: typescript, python-sync, python-async `
+ - `-p, --path <path>: change root directory where command is executed to <path> directory `
+
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/commands/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/commands/page.mdx
new file mode 100644
index 000000000..6187a90f2
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/commands/page.mdx
@@ -0,0 +1,549 @@
+### Commands
+
+Module for starting and interacting with commands in the sandbox.
+
+#### Constructors
+
+```ts
+new Commands(
+ transport: Transport,
+ connectionConfig: ConnectionConfig,
+ metadata: object): Commands
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `transport` | `Transport` |
+| `connectionConfig` | `ConnectionConfig` |
+| `metadata` | `object` |
+| `metadata.version` | `string` |
+
+###### Returns
+
+`Commands`
+
+#### Methods
+
+### connect()
+
+```ts
+connect(pid: number, opts?: CommandConnectOpts): Promise<CommandHandle>
+```
+
+Connect to a running command.
+You can use CommandHandle.wait to wait for the command to finish and get execution results.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `pid` | `number` | process ID of the command to connect to. You can get the list of running commands using Commands.list. |
+| `opts`? | `CommandConnectOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`CommandHandle`\>
+
+`CommandHandle` handle to interact with the running command.
+
+### kill()
+
+```ts
+kill(pid: number, opts?: CommandRequestOpts): Promise<boolean>
+```
+
+Kill a running command specified by its process ID.
+It uses `SIGKILL` signal to kill the command.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `pid` | `number` | process ID of the command. You can get the list of running commands using Commands.list. |
+| `opts`? | `CommandRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the command was killed, `false` if the command was not found.
+
+### list()
+
+```ts
+list(opts?: CommandRequestOpts): Promise<ProcessInfo[]>
+```
+
+List all running commands and PTY sessions.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts`? | `CommandRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`ProcessInfo`[]\>
+
+list of running commands and PTY sessions.
+
+### run()
+
+###### run(cmd, opts)
+
+```ts
+run(cmd: string, opts?: CommandStartOpts & object): Promise<CommandResult>
+```
+
+Start a new command and wait until it finishes executing.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `cmd` | `string` | command to execute. |
+| `opts`? | `CommandStartOpts` & `object` | options for starting the command. |
+
+###### Returns
+
+`Promise`\<`CommandResult`\>
+
+`CommandResult` result of the command execution.
+
+###### run(cmd, opts)
+
+```ts
+run(cmd: string, opts: CommandStartOpts & object): Promise<CommandHandle>
+```
+
+Start a new command in the background.
+You can use CommandHandle.wait to wait for the command to finish and get its result.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `cmd` | `string` | command to execute. |
+| `opts` | `CommandStartOpts` & `object` | options for starting the command |
+
+###### Returns
+
+`Promise`\<`CommandHandle`\>
+
+`CommandHandle` handle to interact with the running command.
+
+###### run(cmd, opts)
+
+```ts
+run(cmd: string, opts?: CommandStartOpts & object): Promise<CommandResult | CommandHandle>
+```
+
+Start a new command.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `cmd` | `string` | command to execute. |
+| `opts`? | `CommandStartOpts` & `object` | options for starting the command. - `opts.background: true` - runs in background, returns `CommandHandle` - `opts.background: false | undefined` - waits for completion, returns `CommandResult` |
+
+###### Returns
+
+`Promise`\<`CommandResult` \| `CommandHandle`\>
+
+Either a `CommandHandle` or a `CommandResult` (depending on `opts.background`).
+
+### sendStdin()
+
+```ts
+sendStdin(
+ pid: number,
+ data: string,
+opts?: CommandRequestOpts): Promise<void>
+```
+
+Send data to command stdin.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `pid` | `number` | process ID of the command. You can get the list of running commands using Commands.list. |
+| `data` | `string` | data to send to the command. |
+| `opts`? | `CommandRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### Pty
+
+Module for interacting with PTYs (pseudo-terminals) in the sandbox.
+
+#### Constructors
+
+```ts
+new Pty(
+ transport: Transport,
+ connectionConfig: ConnectionConfig,
+ metadata: object): Pty
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `transport` | `Transport` |
+| `connectionConfig` | `ConnectionConfig` |
+| `metadata` | `object` |
+| `metadata.version` | `string` |
+
+###### Returns
+
+`Pty`
+
+#### Methods
+
+### connect()
+
+```ts
+connect(pid: number, opts?: PtyConnectOpts): Promise<CommandHandle>
+```
+
+Connect to a running PTY.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `pid` | `number` | process ID of the PTY to connect to. You can get the list of running PTYs using Commands.list. |
+| `opts`? | `PtyConnectOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`CommandHandle`\>
+
+handle to interact with the PTY.
+
+### create()
+
+```ts
+create(opts: PtyCreateOpts): Promise<CommandHandle>
+```
+
+Create a new PTY (pseudo-terminal).
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts` | `PtyCreateOpts` | options for creating the PTY. |
+
+###### Returns
+
+`Promise`\<`CommandHandle`\>
+
+handle to interact with the PTY.
+
+### kill()
+
+```ts
+kill(pid: number, opts?: Pick<ConnectionOpts, "requestTimeoutMs">): Promise<boolean>
+```
+
+Kill a running PTY specified by process ID.
+It uses `SIGKILL` signal to kill the PTY.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `pid` | `number` | process ID of the PTY. |
+| `opts`? | `Pick`\<`ConnectionOpts`, `"requestTimeoutMs"`\> | connection options. |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the PTY was killed, `false` if the PTY was not found.
+
+### resize()
+
+```ts
+resize(
+ pid: number,
+ size: object,
+opts?: Pick<ConnectionOpts, "requestTimeoutMs">): Promise<void>
+```
+
+Resize PTY.
+Call this when the terminal window is resized and the number of columns and rows has changed.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `pid` | `number` | process ID of the PTY. |
+| `size` | `object` | new size of the PTY. |
+| `size.cols` | `number` | - |
+| `size.rows`? | `number` | - |
+| `opts`? | `Pick`\<`ConnectionOpts`, `"requestTimeoutMs"`\> | connection options. |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+### sendInput()
+
+```ts
+sendInput(
+ pid: number,
+ data: Uint8Array,
+opts?: Pick<ConnectionOpts, "requestTimeoutMs">): Promise<void>
+```
+
+Send input to a PTY.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `pid` | `number` | process ID of the PTY. |
+| `data` | `Uint8Array` | input data to send to the PTY. |
+| `opts`? | `Pick`\<`ConnectionOpts`, `"requestTimeoutMs"`\> | connection options. |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+## Interfaces
+
+### CommandRequestOpts
+
+Options for sending a command request.
+
+#### Extended by
+
+- `CommandStartOpts`
+
+#### Properties
+
+### requestTimeoutMs?
+
+```ts
+optional requestTimeoutMs: number;
+```
+
+Timeout for requests to the API in **milliseconds**.
+
+###### Default
+
+```ts
+60_000 // 60 seconds
+```
+
+***
+
+### CommandStartOpts
+
+Options for starting a new command.
+
+#### Properties
+
+### background?
+
+```ts
+optional background: boolean;
+```
+
+If true, starts command in the background and the method returns immediately.
+You can use CommandHandle.wait to wait for the command to finish.
+
+### cwd?
+
+```ts
+optional cwd: string;
+```
+
+Working directory for the command.
+
+###### Default
+
+```ts
+// home directory of the user used to start the command
+```
+
+### envs?
+
+```ts
+optional envs: Record<string, string>;
+```
+
+Environment variables used for the command.
+
+This overrides the default environment variables from `Sandbox` constructor.
+
+###### Default
+
+`{}`
+
+### onStderr()?
+
+```ts
+optional onStderr: (data: string) => void | Promise<void>;
+```
+
+Callback for command stderr output.
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `data` | `string` |
+
+###### Returns
+
+`void` \| `Promise`\<`void`\>
+
+### onStdout()?
+
+```ts
+optional onStdout: (data: string) => void | Promise<void>;
+```
+
+Callback for command stdout output.
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `data` | `string` |
+
+###### Returns
+
+`void` \| `Promise`\<`void`\>
+
+### requestTimeoutMs?
+
+```ts
+optional requestTimeoutMs: number;
+```
+
+Timeout for requests to the API in **milliseconds**.
+
+###### Default
+
+```ts
+60_000 // 60 seconds
+```
+
+### stdin?
+
+```ts
+optional stdin: boolean;
+```
+
+If true, command stdin is kept open and you can send data to it using Commands.sendStdin or CommandHandle.sendStdin.
+
+###### Default
+
+```ts
+false
+```
+
+### timeoutMs?
+
+```ts
+optional timeoutMs: number;
+```
+
+Timeout for the command in **milliseconds**.
+
+###### Default
+
+```ts
+60_000 // 60 seconds
+```
+
+### user?
+
+```ts
+optional user: string;
+```
+
+User to run the command as.
+
+###### Default
+
+`default Sandbox user (as specified in the template)`
+
+***
+
+### ProcessInfo
+
+Information about a command, PTY session or start command running in the sandbox as process.
+
+#### Properties
+
+### args
+
+```ts
+args: string[];
+```
+
+Command arguments.
+
+### cmd
+
+```ts
+cmd: string;
+```
+
+Command that was executed.
+
+### cwd?
+
+```ts
+optional cwd: string;
+```
+
+Executed command working directory.
+
+### envs
+
+```ts
+envs: Record<string, string>;
+```
+
+Environment variables used for the command.
+
+### pid
+
+```ts
+pid: number;
+```
+
+Process ID.
+
+### tag?
+
+```ts
+optional tag: string;
+```
+
+Custom tag used for identifying special commands like start command in the custom template.
+
+## Type Aliases
+
+### CommandConnectOpts
+
+```ts
+type CommandConnectOpts: Pick<CommandStartOpts, "onStderr" | "onStdout" | "timeoutMs"> & CommandRequestOpts;
+```
+
+Options for connecting to a command.
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/errors/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/errors/page.mdx
new file mode 100644
index 000000000..a267c059e
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/errors/page.mdx
@@ -0,0 +1,266 @@
+### AuthenticationError
+
+Thrown when authentication fails.
+
+#### Constructors
+
+```ts
+new AuthenticationError(message: string): AuthenticationError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+
+###### Returns
+
+`AuthenticationError`
+
+***
+
+### BuildError
+
+Thrown when the build fails.
+
+#### Extended by
+
+- `FileUploadError`
+
+#### Constructors
+
+```ts
+new BuildError(message: string, stackTrace?: string): BuildError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`BuildError`
+
+***
+
+### FileUploadError
+
+Thrown when the file upload fails.
+
+#### Constructors
+
+```ts
+new FileUploadError(message: string, stackTrace?: string): FileUploadError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`FileUploadError`
+
+***
+
+### InvalidArgumentError
+
+Thrown when an invalid argument is provided.
+
+#### Constructors
+
+```ts
+new InvalidArgumentError(message: string, stackTrace?: string): InvalidArgumentError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`InvalidArgumentError`
+
+***
+
+### NotEnoughSpaceError
+
+Thrown when there is not enough disk space.
+
+#### Constructors
+
+```ts
+new NotEnoughSpaceError(message: string, stackTrace?: string): NotEnoughSpaceError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`NotEnoughSpaceError`
+
+***
+
+### NotFoundError
+
+Thrown when a resource is not found.
+
+#### Constructors
+
+```ts
+new NotFoundError(message: string, stackTrace?: string): NotFoundError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`NotFoundError`
+
+***
+
+### RateLimitError
+
+Thrown when the API rate limit is exceeded.
+
+#### Constructors
+
+```ts
+new RateLimitError(message: string): RateLimitError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+
+###### Returns
+
+`RateLimitError`
+
+***
+
+### SandboxError
+
+Base class for all sandbox errors.
+
+Thrown when general sandbox errors occur.
+
+#### Extended by
+
+- `TimeoutError`
+- `InvalidArgumentError`
+- `NotEnoughSpaceError`
+- `NotFoundError`
+- `TemplateError`
+- `RateLimitError`
+
+#### Constructors
+
+```ts
+new SandboxError(message?: string, stackTrace?: string): SandboxError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message`? | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`SandboxError`
+
+***
+
+### TemplateError
+
+Thrown when the template uses old envd version. It isn't compatible with the new SDK.
+
+#### Constructors
+
+```ts
+new TemplateError(message: string, stackTrace?: string): TemplateError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`TemplateError`
+
+***
+
+### TimeoutError
+
+Thrown when a timeout error occurs.
+
+The [unavailable] error type is caused by sandbox timeout.
+
+The [canceled] error type is caused by exceeding request timeout.
+
+The [deadline_exceeded] error type is caused by exceeding the timeout for command execution, watch, etc.
+
+The [unknown] error type is sometimes caused by the sandbox timeout when the request is not processed correctly.
+
+#### Constructors
+
+```ts
+new TimeoutError(message: string, stackTrace?: string): TimeoutError
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `stackTrace`? | `string` |
+
+###### Returns
+
+`TimeoutError`
+
+## Functions
+
+### formatSandboxTimeoutError()
+
+```ts
+function formatSandboxTimeoutError(message: string): TimeoutError
+```
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+
+#### Returns
+
+`TimeoutError`
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/filesystem/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/filesystem/page.mdx
new file mode 100644
index 000000000..b23d35552
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/filesystem/page.mdx
@@ -0,0 +1,649 @@
+### FileType
+
+Sandbox filesystem object type.
+
+#### Enumeration Members
+
+| Enumeration Member | Value | Description |
+| ------ | ------ | ------ |
+| `DIR` | `"dir"` | Filesystem object is a directory. |
+| `FILE` | `"file"` | Filesystem object is a file. |
+
+## Classes
+
+### Filesystem
+
+Module for interacting with the sandbox filesystem.
+
+#### Constructors
+
+```ts
+new Filesystem(
+ transport: Transport,
+ envdApi: EnvdApiClient,
+ connectionConfig: ConnectionConfig): Filesystem
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `transport` | `Transport` |
+| `envdApi` | `EnvdApiClient` |
+| `connectionConfig` | `ConnectionConfig` |
+
+###### Returns
+
+`Filesystem`
+
+#### Methods
+
+### exists()
+
+```ts
+exists(path: string, opts?: FilesystemRequestOpts): Promise<boolean>
+```
+
+Check if a file or a directory exists.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to a file or a directory |
+| `opts`? | `FilesystemRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the file or directory exists, `false` otherwise
+
+### getInfo()
+
+```ts
+getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>
+```
+
+Get information about a file or directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to a file or directory. |
+| `opts`? | `FilesystemRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`EntryInfo`\>
+
+information about the file or directory like name, type, and path.
+
+### list()
+
+```ts
+list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo[]>
+```
+
+List entries in a directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to the directory. |
+| `opts`? | `FilesystemListOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`EntryInfo`[]\>
+
+list of entries in the sandbox filesystem directory.
+
+### makeDir()
+
+```ts
+makeDir(path: string, opts?: FilesystemRequestOpts): Promise<boolean>
+```
+
+Create a new directory and all directories along the way if needed on the specified path.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to a new directory. For example '/dirA/dirB' when creating 'dirB'. |
+| `opts`? | `FilesystemRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the directory was created, `false` if it already exists.
+
+### read()
+
+###### read(path, opts)
+
+```ts
+read(path: string, opts?: FilesystemRequestOpts & object): Promise<string>
+```
+
+Read file content as a `string`.
+
+You can pass `text`, `bytes`, `blob`, or `stream` to `opts.format` to change the return type.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to the file. |
+| `opts`? | `FilesystemRequestOpts` & `object` | connection options. |
+
+###### Returns
+
+`Promise`\<`string`\>
+
+file content as string
+
+###### read(path, opts)
+
+```ts
+read(path: string, opts?: FilesystemRequestOpts & object): Promise<Uint8Array>
+```
+
+Read file content as a `Uint8Array`.
+
+You can pass `text`, `bytes`, `blob`, or `stream` to `opts.format` to change the return type.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to the file. |
+| `opts`? | `FilesystemRequestOpts` & `object` | connection options. |
+
+###### Returns
+
+`Promise`\<`Uint8Array`\>
+
+file content as `Uint8Array`
+
+###### read(path, opts)
+
+```ts
+read(path: string, opts?: FilesystemRequestOpts & object): Promise<Blob>
+```
+
+Read file content as a `Blob`.
+
+You can pass `text`, `bytes`, `blob`, or `stream` to `opts.format` to change the return type.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to the file. |
+| `opts`? | `FilesystemRequestOpts` & `object` | connection options. |
+
+###### Returns
+
+`Promise`\<`Blob`\>
+
+file content as `Blob`
+
+###### read(path, opts)
+
+```ts
+read(path: string, opts?: FilesystemRequestOpts & object): Promise<ReadableStream<Uint8Array>>
+```
+
+Read file content as a `ReadableStream`.
+
+You can pass `text`, `bytes`, `blob`, or `stream` to `opts.format` to change the return type.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to the file. |
+| `opts`? | `FilesystemRequestOpts` & `object` | connection options. |
+
+###### Returns
+
+`Promise`\<`ReadableStream`\<`Uint8Array`\>\>
+
+file content as `ReadableStream`
+
+### remove()
+
+```ts
+remove(path: string, opts?: FilesystemRequestOpts): Promise<void>
+```
+
+Remove a file or directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to a file or directory. |
+| `opts`? | `FilesystemRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+### rename()
+
+```ts
+rename(
+ oldPath: string,
+ newPath: string,
+opts?: FilesystemRequestOpts): Promise<EntryInfo>
+```
+
+Rename a file or directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `oldPath` | `string` | path to the file or directory to rename. |
+| `newPath` | `string` | new path for the file or directory. |
+| `opts`? | `FilesystemRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`EntryInfo`\>
+
+information about renamed file or directory.
+
+### watchDir()
+
+```ts
+watchDir(
+ path: string,
+ onEvent: (event: FilesystemEvent) => void | Promise<void>,
+opts?: WatchOpts & object): Promise<WatchHandle>
+```
+
+Start watching a directory for filesystem events.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to directory to watch. |
+| `onEvent` | (`event`: `FilesystemEvent`) => `void` \| `Promise`\<`void`\> | callback to call when an event in the directory occurs. |
+| `opts`? | `WatchOpts` & `object` | connection options. |
+
+###### Returns
+
+`Promise`\<`WatchHandle`\>
+
+`WatchHandle` object for stopping watching directory.
+
+### write()
+
+###### write(path, data, opts)
+
+```ts
+write(
+ path: string,
+ data: string | ArrayBuffer | Blob | ReadableStream<any>,
+opts?: FilesystemRequestOpts): Promise<WriteInfo>
+```
+
+Write content to a file.
+
+Writing to a file that doesn't exist creates the file.
+
+Writing to a file that already exists overwrites the file.
+
+Writing to a file at path that doesn't exist creates the necessary directories.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to file. |
+| `data` | `string` \| `ArrayBuffer` \| `Blob` \| `ReadableStream`\<`any`\> | data to write to the file. Data can be a string, `ArrayBuffer`, `Blob`, or `ReadableStream`. |
+| `opts`? | `FilesystemRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`WriteInfo`\>
+
+information about the written file
+
+###### write(files, opts)
+
+```ts
+write(files: WriteEntry[], opts?: FilesystemRequestOpts): Promise<WriteInfo[]>
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `files` | `WriteEntry`[] |
+| `opts`? | `FilesystemRequestOpts` |
+
+###### Returns
+
+`Promise`\<`WriteInfo`[]\>
+
+### writeFiles()
+
+```ts
+writeFiles(files: WriteEntry[], opts?: FilesystemRequestOpts): Promise<WriteInfo[]>
+```
+
+Write multiple files.
+
+Writing to a file that doesn't exist creates the file.
+
+Writing to a file that already exists overwrites the file.
+
+Writing to a file at path that doesn't exist creates the necessary directories.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `files` | `WriteEntry`[] | list of files to write as `WriteEntry` objects, each containing `path` and `data`. |
+| `opts`? | `FilesystemRequestOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`WriteInfo`[]\>
+
+information about the written files
+
+## Interfaces
+
+### EntryInfo
+
+Sandbox filesystem object information.
+
+#### Properties
+
+### group
+
+```ts
+group: string;
+```
+
+Group owner of the filesystem object.
+
+### mode
+
+```ts
+mode: number;
+```
+
+File mode and permission bits.
+
+### modifiedTime?
+
+```ts
+optional modifiedTime: Date;
+```
+
+Last modification time of the filesystem object.
+
+### name
+
+```ts
+name: string;
+```
+
+Name of the filesystem object.
+
+### owner
+
+```ts
+owner: string;
+```
+
+Owner of the filesystem object.
+
+### path
+
+```ts
+path: string;
+```
+
+Path to the filesystem object.
+
+### permissions
+
+```ts
+permissions: string;
+```
+
+String representation of file permissions (e.g. 'rwxr-xr-x').
+
+### size
+
+```ts
+size: number;
+```
+
+Size of the filesystem object in bytes.
+
+### symlinkTarget?
+
+```ts
+optional symlinkTarget: string;
+```
+
+If the filesystem object is a symlink, this is the target of the symlink.
+
+### type?
+
+```ts
+optional type: FileType;
+```
+
+Type of the filesystem object.
+
+***
+
+### FilesystemListOpts
+
+Options for the sandbox filesystem operations.
+
+#### Properties
+
+### depth?
+
+```ts
+optional depth: number;
+```
+
+Depth of the directory to list.
+
+### requestTimeoutMs?
+
+```ts
+optional requestTimeoutMs: number;
+```
+
+Timeout for requests to the API in **milliseconds**.
+
+###### Default
+
+```ts
+60_000 // 60 seconds
+```
+
+### user?
+
+```ts
+optional user: string;
+```
+
+User to use for the operation in the sandbox.
+This affects the resolution of relative paths and ownership of the created filesystem objects.
+
+***
+
+### FilesystemRequestOpts
+
+Options for the sandbox filesystem operations.
+
+#### Extended by
+
+- `FilesystemListOpts`
+- `WatchOpts`
+
+#### Properties
+
+### requestTimeoutMs?
+
+```ts
+optional requestTimeoutMs: number;
+```
+
+Timeout for requests to the API in **milliseconds**.
+
+###### Default
+
+```ts
+60_000 // 60 seconds
+```
+
+### user?
+
+```ts
+optional user: string;
+```
+
+User to use for the operation in the sandbox.
+This affects the resolution of relative paths and ownership of the created filesystem objects.
+
+***
+
+### WatchOpts
+
+Options for watching a directory.
+
+#### Properties
+
+### onExit()?
+
+```ts
+optional onExit: (err?: Error) => void | Promise<void>;
+```
+
+Callback to call when the watch operation stops.
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `err`? | `Error` |
+
+###### Returns
+
+`void` \| `Promise`\<`void`\>
+
+### recursive?
+
+```ts
+optional recursive: boolean;
+```
+
+Watch the directory recursively
+
+### requestTimeoutMs?
+
+```ts
+optional requestTimeoutMs: number;
+```
+
+Timeout for requests to the API in **milliseconds**.
+
+###### Default
+
+```ts
+60_000 // 60 seconds
+```
+
+### timeoutMs?
+
+```ts
+optional timeoutMs: number;
+```
+
+Timeout for the watch operation in **milliseconds**.
+You can pass `0` to disable the timeout.
+
+###### Default
+
+```ts
+60_000 // 60 seconds
+```
+
+### user?
+
+```ts
+optional user: string;
+```
+
+User to use for the operation in the sandbox.
+This affects the resolution of relative paths and ownership of the created filesystem objects.
+
+***
+
+### WriteInfo
+
+Sandbox filesystem object information.
+
+#### Extended by
+
+- `EntryInfo`
+
+#### Properties
+
+### name
+
+```ts
+name: string;
+```
+
+Name of the filesystem object.
+
+### path
+
+```ts
+path: string;
+```
+
+Path to the filesystem object.
+
+### type?
+
+```ts
+optional type: FileType;
+```
+
+Type of the filesystem object.
+
+## Type Aliases
+
+### WriteEntry
+
+```ts
+type WriteEntry: object;
+```
+
+#### Type declaration
+
+| Name | Type |
+| ------ | ------ |
+| `data` | `string` \| `ArrayBuffer` \| `Blob` \| `ReadableStream` |
+| `path` | `string` |
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/sandbox/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/sandbox/page.mdx
new file mode 100644
index 000000000..afd10b84d
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/sandbox/page.mdx
@@ -0,0 +1,706 @@
+### Sandbox
+
+E2B cloud sandbox is a secure and isolated cloud environment.
+
+The sandbox allows you to:
+- Access Linux OS
+- Create, list, and delete files and directories
+- Run commands
+- Run isolated code
+- Access the internet
+
+Check docs here.
+
+Use Sandbox.create to create a new sandbox.
+
+#### Example
+
+```ts
+import { Sandbox } from 'e2b'
+
+const sandbox = await Sandbox.create()
+```
+
+#### Properties
+
+| Property | Modifier | Type | Description |
+| ------ | ------ | ------ | ------ |
+| `commands` | `readonly` | `Commands` | Module for running commands in the sandbox |
+| `files` | `readonly` | `Filesystem` | Module for interacting with the sandbox filesystem |
+| `pty` | `readonly` | `Pty` | Module for interacting with the sandbox pseudo-terminals |
+| `sandboxDomain` | `readonly` | `string` | Domain where the sandbox is hosted. |
+| `sandboxId` | `readonly` | `string` | Unique identifier of the sandbox. |
+| `trafficAccessToken?` | `readonly` | `string` | Traffic access token for accessing sandbox services with restricted public traffic. |
+
+#### Methods
+
+### betaPause()
+
+```ts
+betaPause(opts?: ConnectionOpts): Promise<boolean>
+```
+
+**`Beta`**
+
+This feature is in beta and may change in the future.
+
+Pause a sandbox by its ID.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts`? | `ConnectionOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+sandbox ID that can be used to resume the sandbox.
+
+### connect()
+
+```ts
+connect(opts?: SandboxBetaCreateOpts): Promise<Sandbox>
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts`? | `SandboxBetaCreateOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`Sandbox`\>
+
+A running sandbox instance
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.create()
+await sandbox.betaPause()
+
+// Connect to the same sandbox.
+const sameSandbox = await sandbox.connect()
+```
+
+### downloadUrl()
+
+```ts
+downloadUrl(path: string, opts?: SandboxUrlOpts): Promise<string>
+```
+
+Get the URL to download a file from the sandbox.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `string` | path to the file in the sandbox. |
+| `opts`? | `SandboxUrlOpts` | download url options. |
+
+###### Returns
+
+`Promise`\<`string`\>
+
+URL for downloading file.
+
+### getHost()
+
+```ts
+getHost(port: number): string
+```
+
+Get the host address for the specified sandbox port.
+You can then use this address to connect to the sandbox port from outside the sandbox via HTTP or WebSocket.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `port` | `number` | number of the port in the sandbox. |
+
+###### Returns
+
+`string`
+
+host address of the sandbox port.
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.create()
+// Start an HTTP server
+await sandbox.commands.exec('python3 -m http.server 3000')
+// Get the hostname of the HTTP server
+const serverURL = sandbox.getHost(3000)
+```
+
+### getInfo()
+
+```ts
+getInfo(opts?: Pick<SandboxOpts, "requestTimeoutMs">): Promise<SandboxInfo>
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts`? | `Pick`\<`SandboxOpts`, `"requestTimeoutMs"`\> | connection options. |
+
+###### Returns
+
+`Promise`\<`SandboxInfo`\>
+
+information about the sandbox
+
+### getMcpToken()
+
+```ts
+getMcpToken(): Promise<undefined | string>
+```
+
+Get the MCP token for the sandbox.
+
+###### Returns
+
+`Promise`\<`undefined` \| `string`\>
+
+MCP token for the sandbox, or undefined if MCP is not enabled.
+
+### getMcpUrl()
+
+```ts
+getMcpUrl(): string
+```
+
+Get the MCP URL for the sandbox.
+
+###### Returns
+
+`string`
+
+MCP URL for the sandbox.
+
+### getMetrics()
+
+```ts
+getMetrics(opts?: SandboxMetricsOpts): Promise<SandboxMetrics[]>
+```
+
+Get the metrics of the sandbox.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts`? | `SandboxMetricsOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`SandboxMetrics`[]\>
+
+List of sandbox metrics containing CPU, memory and disk usage information.
+
+### isRunning()
+
+```ts
+isRunning(opts?: Pick<ConnectionOpts, "requestTimeoutMs">): Promise<boolean>
+```
+
+Check if the sandbox is running.
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `opts`? | `Pick`\<`ConnectionOpts`, `"requestTimeoutMs"`\> |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the sandbox is running, `false` otherwise.
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.create()
+await sandbox.isRunning() // Returns true
+
+await sandbox.kill()
+await sandbox.isRunning() // Returns false
+```
+
+### kill()
+
+```ts
+kill(opts?: Pick<SandboxOpts, "requestTimeoutMs">): Promise<void>
+```
+
+Kill the sandbox.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts`? | `Pick`\<`SandboxOpts`, `"requestTimeoutMs"`\> | connection options. |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+### setTimeout()
+
+```ts
+setTimeout(timeoutMs: number, opts?: Pick<SandboxOpts, "requestTimeoutMs">): Promise<void>
+```
+
+Set the timeout of the sandbox.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to `.setTimeout`.
+Maximum time a sandbox can be kept alive is 24 hours (86_400_000 milliseconds) for Pro users and 1 hour (3_600_000 milliseconds) for Hobby users.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `timeoutMs` | `number` | timeout in **milliseconds**. |
+| `opts`? | `Pick`\<`SandboxOpts`, `"requestTimeoutMs"`\> | connection options. |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+### uploadUrl()
+
+```ts
+uploadUrl(path?: string, opts?: SandboxUrlOpts): Promise<string>
+```
+
+Get the URL to upload a file to the sandbox.
+
+You have to send a POST request to this URL with the file as multipart/form-data.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path`? | `string` | path to the file in the sandbox. |
+| `opts`? | `SandboxUrlOpts` | download url options. |
+
+###### Returns
+
+`Promise`\<`string`\>
+
+URL for uploading file.
+
+### betaCreate()
+
+###### betaCreate(this, opts)
+
+```ts
+static betaCreate<S>(this: S, opts?: SandboxBetaCreateOpts): Promise<InstanceType<S>>
+```
+
+**`Beta`**
+
+This feature is in beta and may change in the future.
+
+Create a new sandbox from the default `base` sandbox template.
+
+###### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `S` *extends* *typeof* `Sandbox` |
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `this` | `S` | - |
+| `opts`? | `SandboxBetaCreateOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`InstanceType`\<`S`\>\>
+
+sandbox instance for the new sandbox.
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.betaCreate()
+```
+
+###### Constructs
+
+Sandbox
+
+###### betaCreate(this, template, opts)
+
+```ts
+static betaCreate<S>(
+ this: S,
+ template: string,
+opts?: SandboxBetaCreateOpts): Promise<InstanceType<S>>
+```
+
+**`Beta`**
+
+This feature is in beta and may change in the future.
+
+Create a new sandbox from the specified sandbox template.
+
+###### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `S` *extends* *typeof* `Sandbox` |
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `this` | `S` | - |
+| `template` | `string` | sandbox template name or ID. |
+| `opts`? | `SandboxBetaCreateOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`InstanceType`\<`S`\>\>
+
+sandbox instance for the new sandbox.
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.betaCreate('<template-name-or-id>')
+```
+
+###### Constructs
+
+Sandbox
+
+### betaPause()
+
+```ts
+static betaPause(sandboxId: string, opts?: SandboxApiOpts): Promise<boolean>
+```
+
+Pause the sandbox specified by sandbox ID.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `sandboxId` | `string` | sandbox ID. |
+| `opts`? | `SandboxApiOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the sandbox got paused, `false` if the sandbox was already paused.
+
+### connect()
+
+```ts
+static connect<S>(
+ this: S,
+ sandboxId: string,
+opts?: SandboxConnectOpts): Promise<InstanceType<S>>
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+###### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `S` *extends* *typeof* `Sandbox` |
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `this` | `S` | - |
+| `sandboxId` | `string` | sandbox ID. |
+| `opts`? | `SandboxConnectOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`InstanceType`\<`S`\>\>
+
+A running sandbox instance
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.create()
+const sandboxId = sandbox.sandboxId
+
+// Connect to the same sandbox.
+const sameSandbox = await Sandbox.connect(sandboxId)
+```
+
+### create()
+
+###### create(this, opts)
+
+```ts
+static create<S>(this: S, opts?: SandboxOpts): Promise<InstanceType<S>>
+```
+
+Create a new sandbox from the default `base` sandbox template.
+
+###### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `S` *extends* *typeof* `Sandbox` |
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `this` | `S` | - |
+| `opts`? | `SandboxOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`InstanceType`\<`S`\>\>
+
+sandbox instance for the new sandbox.
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.create()
+```
+
+###### Constructs
+
+Sandbox
+
+###### create(this, template, opts)
+
+```ts
+static create<S>(
+ this: S,
+ template: string,
+opts?: SandboxOpts): Promise<InstanceType<S>>
+```
+
+Create a new sandbox from the specified sandbox template.
+
+###### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `S` *extends* *typeof* `Sandbox` |
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `this` | `S` | - |
+| `template` | `string` | sandbox template name or ID. |
+| `opts`? | `SandboxOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`InstanceType`\<`S`\>\>
+
+sandbox instance for the new sandbox.
+
+###### Example
+
+```ts
+const sandbox = await Sandbox.create('<template-name-or-id>')
+```
+
+###### Constructs
+
+Sandbox
+
+### getFullInfo()
+
+```ts
+static getFullInfo(sandboxId: string, opts?: SandboxApiOpts): Promise<object>
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `sandboxId` | `string` |
+| `opts`? | `SandboxApiOpts` |
+
+###### Returns
+
+`Promise`\<`object`\>
+
+| Name | Type | Default value |
+| ------ | ------ | ------ |
+| `cpuCount` | `number` | res.data.cpuCount |
+| `endAt` | `Date` | - |
+| `envdAccessToken` | `undefined` \| `string` | res.data.envdAccessToken |
+| `envdVersion` | `string` | res.data.envdVersion |
+| `memoryMB` | `number` | res.data.memoryMB |
+| `metadata` | `object` | - |
+| `name`? | `string` | res.data.alias |
+| `sandboxDomain` | `undefined` \| `string` | - |
+| `sandboxId` | `string` | res.data.sandboxID |
+| `startedAt` | `Date` | - |
+| `state` | `"running"` \| `"paused"` | res.data.state |
+| `templateId` | `string` | res.data.templateID |
+
+### getInfo()
+
+```ts
+static getInfo(sandboxId: string, opts?: SandboxApiOpts): Promise<SandboxInfo>
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `sandboxId` | `string` | sandbox ID. |
+| `opts`? | `SandboxApiOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`SandboxInfo`\>
+
+sandbox information.
+
+### getMetrics()
+
+```ts
+static getMetrics(sandboxId: string, opts?: SandboxMetricsOpts): Promise<SandboxMetrics[]>
+```
+
+Get the metrics of the sandbox.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `sandboxId` | `string` | sandbox ID. |
+| `opts`? | `SandboxMetricsOpts` | sandbox metrics options. |
+
+###### Returns
+
+`Promise`\<`SandboxMetrics`[]\>
+
+List of sandbox metrics containing CPU, memory and disk usage information.
+
+### kill()
+
+```ts
+static kill(sandboxId: string, opts?: SandboxApiOpts): Promise<boolean>
+```
+
+Kill the sandbox specified by sandbox ID.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `sandboxId` | `string` | sandbox ID. |
+| `opts`? | `SandboxApiOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+`true` if the sandbox was found and killed, `false` otherwise.
+
+### list()
+
+```ts
+static list(opts?: SandboxListOpts): SandboxPaginator
+```
+
+List all sandboxes.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `opts`? | `SandboxListOpts` | connection options. |
+
+###### Returns
+
+`SandboxPaginator`
+
+paginator for listing sandboxes.
+
+### setTimeout()
+
+```ts
+static setTimeout(
+ sandboxId: string,
+ timeoutMs: number,
+opts?: SandboxApiOpts): Promise<void>
+```
+
+Set the timeout of the specified sandbox.
+After the timeout expires the sandbox will be automatically killed.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to Sandbox.setTimeout.
+
+Maximum time a sandbox can be kept alive is 24 hours (86_400_000 milliseconds) for Pro users and 1 hour (3_600_000 milliseconds) for Hobby users.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `sandboxId` | `string` | sandbox ID. |
+| `timeoutMs` | `number` | timeout in **milliseconds**. |
+| `opts`? | `SandboxApiOpts` | connection options. |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+## Interfaces
+
+### SandboxUrlOpts
+
+Options for sandbox upload/download URL generation.
+
+#### Properties
+
+### user?
+
+```ts
+optional user: string;
+```
+
+User that will be used to access the file.
+
+### useSignatureExpiration?
+
+```ts
+optional useSignatureExpiration: number;
+```
+
+Use signature expiration for the URL.
+Optional parameter to set the expiration time for the signature in seconds.
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/logger/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/logger/page.mdx
new file mode 100644
index 000000000..950551c97
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/logger/page.mdx
@@ -0,0 +1,191 @@
+### LogEntry
+
+Represents a single log entry from the template build process.
+
+#### Extended by
+
+- `LogEntryStart`
+- `LogEntryEnd`
+
+#### Constructors
+
+```ts
+new LogEntry(
+ timestamp: Date,
+ level: LogEntryLevel,
+ message: string): LogEntry
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `timestamp` | `Date` |
+| `level` | `LogEntryLevel` |
+| `message` | `string` |
+
+###### Returns
+
+`LogEntry`
+
+#### Properties
+
+| Property | Modifier | Type |
+| ------ | ------ | ------ |
+| `level` | `readonly` | `LogEntryLevel` |
+| `message` | `readonly` | `string` |
+| `timestamp` | `readonly` | `Date` |
+
+#### Methods
+
+### toString()
+
+```ts
+toString(): string
+```
+
+###### Returns
+
+`string`
+
+***
+
+### LogEntryEnd
+
+Special log entry indicating the end of a build process.
+
+#### Constructors
+
+```ts
+new LogEntryEnd(timestamp: Date, message: string): LogEntryEnd
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `timestamp` | `Date` |
+| `message` | `string` |
+
+###### Returns
+
+`LogEntryEnd`
+
+#### Properties
+
+| Property | Modifier | Type | Inherited from |
+| ------ | ------ | ------ | ------ |
+| `level` | `readonly` | `LogEntryLevel` | `LogEntry`.`level` |
+| `message` | `readonly` | `string` | `LogEntry`.`message` |
+| `timestamp` | `readonly` | `Date` | `LogEntry`.`timestamp` |
+
+#### Methods
+
+### toString()
+
+```ts
+toString(): string
+```
+
+###### Returns
+
+`string`
+
+***
+
+### LogEntryStart
+
+Special log entry indicating the start of a build process.
+
+#### Constructors
+
+```ts
+new LogEntryStart(timestamp: Date, message: string): LogEntryStart
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `timestamp` | `Date` |
+| `message` | `string` |
+
+###### Returns
+
+`LogEntryStart`
+
+#### Properties
+
+| Property | Modifier | Type | Inherited from |
+| ------ | ------ | ------ | ------ |
+| `level` | `readonly` | `LogEntryLevel` | `LogEntry`.`level` |
+| `message` | `readonly` | `string` | `LogEntry`.`message` |
+| `timestamp` | `readonly` | `Date` | `LogEntry`.`timestamp` |
+
+#### Methods
+
+### toString()
+
+```ts
+toString(): string
+```
+
+###### Returns
+
+`string`
+
+## Type Aliases
+
+### LogEntryLevel
+
+```ts
+type LogEntryLevel: "debug" | "info" | "warn" | "error";
+```
+
+Log entry severity levels.
+
+## Functions
+
+### defaultBuildLogger()
+
+```ts
+function defaultBuildLogger(options?: object): (logEntry: LogEntry) => void
+```
+
+Create a default build logger with animated timer display.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options`? | `object` | Logger configuration options |
+| `options.minLevel`? | `LogEntryLevel` | Minimum log level to display (default: 'info') |
+
+#### Returns
+
+`Function`
+
+Logger function that accepts LogEntry instances
+
+### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `logEntry` | `LogEntry` |
+
+### Returns
+
+`void`
+
+#### Example
+
+```ts
+import { Template, defaultBuildLogger } from 'e2b'
+
+const template = Template().fromPythonImage()
+
+await Template.build(template, {
+ alias: 'my-template',
+ onBuildLogs: defaultBuildLogger({ minLevel: 'debug' })
+})
+```
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/page.mdx
new file mode 100644
index 000000000..2da0b1e5f
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/page.mdx
@@ -0,0 +1,2283 @@
+### TemplateBase
+
+Base class for building E2B sandbox templates.
+
+#### Implements
+
+- `TemplateFromImage`
+- `TemplateBuilder`
+- `TemplateFinal`
+
+#### Constructors
+
+```ts
+new TemplateBase(options?: TemplateOptions): TemplateBase
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `options`? | `TemplateOptions` |
+
+###### Returns
+
+`TemplateBase`
+
+#### Methods
+
+### addMcpServer()
+
+```ts
+addMcpServer(servers: keyof McpServer | keyof McpServer[]): TemplateBuilder
+```
+
+Install MCP servers using mcp-gateway.
+Note: Requires a base image with mcp-gateway pre-installed (e.g., mcp-gateway).
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `servers` | keyof McpServer \| keyof McpServer[] | MCP server name(s) |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Throws
+
+If the base template is not mcp-gateway
+
+###### Example
+
+```ts
+template.addMcpServer('exa')
+template.addMcpServer(['brave', 'firecrawl', 'duckduckgo'])
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`addMcpServer`
+
+### aptInstall()
+
+```ts
+aptInstall(packages: string | string[], options?: object): TemplateBuilder
+```
+
+Install Debian/Ubuntu packages using apt-get.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages` | `string` \| `string`[] | Package name(s) |
+| `options`? | `object` | - |
+| `options.noInstallRecommends`? | `boolean` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.aptInstall('vim')
+template.aptInstall(['git', 'curl', 'wget'])
+template.aptInstall(['vim'], { noInstallRecommends: true })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`aptInstall`
+
+### betaDevContainerPrebuild()
+
+```ts
+betaDevContainerPrebuild(devcontainerDirectory: string): TemplateBuilder
+```
+
+Prebuild a devcontainer from the specified directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `devcontainerDirectory` | `string` | Path to the devcontainer directory |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template
+ .gitClone('https://myrepo.com/project.git', '/my-devcontainer')
+ .betaDevContainerPrebuild('/my-devcontainer')
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`betaDevContainerPrebuild`
+
+### betaSetDevContainerStart()
+
+```ts
+betaSetDevContainerStart(devcontainerDirectory: string): TemplateFinal
+```
+
+Start a devcontainer from the specified directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `devcontainerDirectory` | `string` | Path to the devcontainer directory |
+
+###### Returns
+
+`TemplateFinal`
+
+###### Example
+
+```ts
+template
+ .gitClone('https://myrepo.com/project.git', '/my-devcontainer')
+ .startDevcontainer('/my-devcontainer')
+
+// Prebuild and start
+template
+ .gitClone('https://myrepo.com/project.git', '/my-devcontainer')
+ .betaDevContainerPrebuild('/my-devcontainer')
+ // Other instructions...
+ .betaSetDevContainerStart('/my-devcontainer')
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`betaSetDevContainerStart`
+
+### bunInstall()
+
+```ts
+bunInstall(packages?: string | string[], options?: object): TemplateBuilder
+```
+
+Install Bun packages using bun.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages`? | `string` \| `string`[] | Package name(s) or undefined for package.json |
+| `options`? | `object` | Install options |
+| `options.dev`? | `boolean` | - |
+| `options.g`? | `boolean` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.bunInstall('express')
+template.bunInstall(['lodash', 'axios'])
+template.bunInstall('tsx', { g: true })
+template.bunInstall('typescript', { dev: true })
+template.bunInstall() // Installs from package.json
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`bunInstall`
+
+### copy()
+
+```ts
+copy(
+ src: PathLike | PathLike[],
+ dest: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Copy files or directories into the template.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `src` | `PathLike` \| `PathLike`[] | Source path(s) |
+| `dest` | `PathLike` | Destination path |
+| `options`? | `object` | Copy options |
+| `options.forceUpload`? | `true` | - |
+| `options.mode`? | `number` | - |
+| `options.resolveSymlinks`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.copy('requirements.txt', '/home/user/')
+template.copy(['app.ts', 'config.ts'], '/app/', { mode: 0o755 })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`copy`
+
+### copyItems()
+
+```ts
+copyItems(items: CopyItem[]): TemplateBuilder
+```
+
+Copy multiple items with individual options.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `items` | `CopyItem`[] | Array of copy items |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.copyItems([
+ { src: 'app.ts', dest: '/app/' },
+ { src: 'config.ts', dest: '/app/', mode: 0o644 }
+])
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`copyItems`
+
+### fromAWSRegistry()
+
+```ts
+fromAWSRegistry(image: string, credentials: object): TemplateBuilder
+```
+
+Start from a Docker image in AWS ECR.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `image` | `string` | Full ECR image path |
+| `credentials` | `object` | AWS credentials |
+| `credentials.accessKeyId` | `string` | - |
+| `credentials.region` | `string` | - |
+| `credentials.secretAccessKey` | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromAWSRegistry(
+ '123456789.dkr.ecr.us-west-2.amazonaws.com/myimage:latest',
+ {
+ accessKeyId: 'AKIA...',
+ secretAccessKey: '...',
+ region: 'us-west-2'
+ }
+)
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromAWSRegistry`
+
+### fromBaseImage()
+
+```ts
+fromBaseImage(): TemplateBuilder
+```
+
+Start from E2B's default base image (e2bdev/base:latest).
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromBaseImage()
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromBaseImage`
+
+### fromBunImage()
+
+```ts
+fromBunImage(variant: string): TemplateBuilder
+```
+
+Start from a Bun-based Docker image.
+
+###### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `variant` | `string` | `'latest'` | Bun variant (default: 'latest') |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromBunImage('1.3')
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromBunImage`
+
+### fromDebianImage()
+
+```ts
+fromDebianImage(variant: string): TemplateBuilder
+```
+
+Start from a Debian-based Docker image.
+
+###### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `variant` | `string` | `'stable'` | Debian variant (default: 'stable') |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromDebianImage('bookworm')
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromDebianImage`
+
+### fromDockerfile()
+
+```ts
+fromDockerfile(dockerfileContentOrPath: string): TemplateBuilder
+```
+
+Parse a Dockerfile and convert it to Template SDK format.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `dockerfileContentOrPath` | `string` | Dockerfile content or path |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromDockerfile('Dockerfile')
+Template().fromDockerfile('FROM python:3\nRUN pip install numpy')
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromDockerfile`
+
+### fromGCPRegistry()
+
+```ts
+fromGCPRegistry(image: string, credentials: object): TemplateBuilder
+```
+
+Start from a Docker image in Google Container Registry.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `image` | `string` | Full GCR/GAR image path |
+| `credentials` | `object` | GCP service account credentials |
+| `credentials.serviceAccountJSON` | `string` \| `object` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromGCPRegistry(
+ 'gcr.io/myproject/myimage:latest',
+ { serviceAccountJSON: 'path/to/service-account.json' }
+)
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromGCPRegistry`
+
+### fromImage()
+
+```ts
+fromImage(baseImage: string, credentials?: object): TemplateBuilder
+```
+
+Start from a custom Docker image.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `baseImage` | `string` | Docker image name |
+| `credentials`? | `object` | Optional credentials for private registries |
+| `credentials.password`? | `string` | - |
+| `credentials.username`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromImage('python:3')
+
+// With credentials (optional)
+Template().fromImage('myregistry.com/myimage:latest', {
+ username: 'user',
+ password: 'pass'
+})
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromImage`
+
+### fromNodeImage()
+
+```ts
+fromNodeImage(variant: string): TemplateBuilder
+```
+
+Start from a Node.js-based Docker image.
+
+###### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `variant` | `string` | `'lts'` | Node.js variant (default: 'lts') |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromNodeImage('24')
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromNodeImage`
+
+### fromPythonImage()
+
+```ts
+fromPythonImage(version: string): TemplateBuilder
+```
+
+Start from a Python-based Docker image.
+
+###### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `version` | `string` | `'3'` | Python version (default: '3') |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromPythonImage('3')
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromPythonImage`
+
+### fromTemplate()
+
+```ts
+fromTemplate(template: string): TemplateBuilder
+```
+
+Start from an existing E2B template.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `template` | `string` | E2B template ID or alias |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromTemplate('my-base-template')
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromTemplate`
+
+### fromUbuntuImage()
+
+```ts
+fromUbuntuImage(variant: string): TemplateBuilder
+```
+
+Start from an Ubuntu-based Docker image.
+
+###### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `variant` | `string` | `'latest'` | Ubuntu variant (default: 'latest') |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+Template().fromUbuntuImage('24.04')
+```
+
+###### Implementation of
+
+`TemplateFromImage.fromUbuntuImage`
+
+### gitClone()
+
+```ts
+gitClone(
+ url: string,
+ path?: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Clone a Git repository.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `url` | `string` | Repository URL |
+| `path`? | `PathLike` | Optional destination path |
+| `options`? | `object` | Clone options |
+| `options.branch`? | `string` | - |
+| `options.depth`? | `number` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.gitClone('https://github.com/user/repo.git', '/app/repo')
+template.gitClone('https://github.com/user/repo.git', undefined, {
+ branch: 'main',
+ depth: 1
+})
+template.gitClone('https://github.com/user/repo.git', '/app/repo', {
+ user: 'root'
+})
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`gitClone`
+
+### makeDir()
+
+```ts
+makeDir(path: PathLike | PathLike[], options?: object): TemplateBuilder
+```
+
+Create directories.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `PathLike` \| `PathLike`[] | Directory path(s) |
+| `options`? | `object` | Directory options |
+| `options.mode`? | `number` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.makeDir('/app/data', { mode: 0o755 })
+template.makeDir(['/app/logs', '/app/cache'])
+template.makeDir('/app/data', { mode: 0o755, user: 'root' })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`makeDir`
+
+### makeSymlink()
+
+```ts
+makeSymlink(
+ src: PathLike,
+ dest: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Create a symbolic link.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `src` | `PathLike` | Source path (target) |
+| `dest` | `PathLike` | Destination path (symlink location) |
+| `options`? | `object` | Symlink options |
+| `options.force`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.makeSymlink('/usr/bin/python3', '/usr/bin/python')
+template.makeSymlink('/usr/bin/python3', '/usr/bin/python', { user: 'root' })
+template.makeSymlink('/usr/bin/python3', '/usr/bin/python', { force: true })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`makeSymlink`
+
+### npmInstall()
+
+```ts
+npmInstall(packages?: string | string[], options?: object): TemplateBuilder
+```
+
+Install Node.js packages using npm.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages`? | `string` \| `string`[] | Package name(s) or undefined for package.json |
+| `options`? | `object` | Install options |
+| `options.dev`? | `boolean` | - |
+| `options.g`? | `boolean` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.npmInstall('express')
+template.npmInstall(['lodash', 'axios'])
+template.npmInstall('tsx', { g: true })
+template.npmInstall('typescript', { dev: true })
+template.npmInstall() // Installs from package.json
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`npmInstall`
+
+### pipInstall()
+
+```ts
+pipInstall(packages?: string | string[], options?: object): TemplateBuilder
+```
+
+Install Python packages using pip.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages`? | `string` \| `string`[] | Package name(s) or undefined for current directory |
+| `options`? | `object` | Install options |
+| `options.g`? | `boolean` | Install globally as root (default: true). Set to false for user-only installation with --user flag |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.pipInstall('numpy') // Installs globally (default)
+template.pipInstall(['pandas', 'scikit-learn'])
+template.pipInstall('numpy', { g: false }) // Install for user only
+template.pipInstall() // Installs from current directory
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`pipInstall`
+
+### remove()
+
+```ts
+remove(path: PathLike | PathLike[], options?: object): TemplateBuilder
+```
+
+Remove files or directories.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `PathLike` \| `PathLike`[] | Path(s) to remove |
+| `options`? | `object` | Remove options |
+| `options.force`? | `boolean` | - |
+| `options.recursive`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.remove('/tmp/cache', { recursive: true, force: true })
+template.remove('/tmp/cache', { recursive: true, force: true, user: 'root' })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`remove`
+
+### rename()
+
+```ts
+rename(
+ src: PathLike,
+ dest: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Rename or move a file or directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `src` | `PathLike` | Source path |
+| `dest` | `PathLike` | Destination path |
+| `options`? | `object` | Rename options |
+| `options.force`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.rename('/tmp/old.txt', '/tmp/new.txt')
+template.rename('/tmp/old.txt', '/tmp/new.txt', { user: 'root' })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`rename`
+
+### runCmd()
+
+###### runCmd(command, options)
+
+```ts
+runCmd(command: string, options?: object): TemplateBuilder
+```
+
+Run a shell command.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `command` | `string` | Command string |
+| `options`? | `object` | Command options |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.runCmd('apt-get update')
+template.runCmd(['pip install numpy', 'pip install pandas'])
+template.runCmd('apt-get install vim', { user: 'root' })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`runCmd`
+
+###### runCmd(commands, options)
+
+```ts
+runCmd(commands: string[], options?: object): TemplateBuilder
+```
+
+Run a shell command.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `commands` | `string`[] | - |
+| `options`? | `object` | Command options |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.runCmd('apt-get update')
+template.runCmd(['pip install numpy', 'pip install pandas'])
+template.runCmd('apt-get install vim', { user: 'root' })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`runCmd`
+
+### setEnvs()
+
+```ts
+setEnvs(envs: Record<string, string>): TemplateBuilder
+```
+
+Set environment variables.
+Note: Environment variables defined here are available only during template build.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `envs` | `Record`\<`string`, `string`\> | Environment variables |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.setEnvs({ NODE_ENV: 'production', PORT: '8080' })
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`setEnvs`
+
+### setReadyCmd()
+
+```ts
+setReadyCmd(readyCommand: string | ReadyCmd): TemplateFinal
+```
+
+Set or update the ready check command.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `readyCommand` | `string` \| `ReadyCmd` | Command to check readiness |
+
+###### Returns
+
+`TemplateFinal`
+
+###### Example
+
+```ts
+// Using a string command
+template.setReadyCmd('curl http://localhost:8000/health')
+
+// Using ReadyCmd helpers
+import { waitForPort, waitForFile, waitForProcess } from 'e2b'
+
+template.setReadyCmd(waitForPort(3000))
+
+template.setReadyCmd(waitForFile('/tmp/ready'))
+
+template.setReadyCmd(waitForProcess('nginx'))
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`setReadyCmd`
+
+### setStartCmd()
+
+```ts
+setStartCmd(startCommand: string, readyCommand: string | ReadyCmd): TemplateFinal
+```
+
+Set the start command and ready check.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `startCommand` | `string` | Command to run on startup |
+| `readyCommand` | `string` \| `ReadyCmd` | Command to check readiness |
+
+###### Returns
+
+`TemplateFinal`
+
+###### Example
+
+```ts
+// Using a string command
+template.setStartCmd(
+ 'node app.js',
+ 'curl http://localhost:8000/health'
+)
+
+// Using ReadyCmd helpers
+import { waitForPort, waitForURL } from 'e2b'
+
+template.setStartCmd(
+ 'python -m http.server 8000',
+ waitForPort(8000)
+)
+
+template.setStartCmd(
+ 'npm start',
+ waitForURL('http://localhost:3000/health', 200)
+)
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`setStartCmd`
+
+### setUser()
+
+```ts
+setUser(user: string): TemplateBuilder
+```
+
+Set the user for subsequent commands.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `user` | `string` | Username |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.setUser('root')
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`setUser`
+
+### setWorkdir()
+
+```ts
+setWorkdir(workdir: PathLike): TemplateBuilder
+```
+
+Set the working directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `workdir` | `PathLike` | Working directory path |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.setWorkdir('/app')
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`setWorkdir`
+
+### skipCache()
+
+```ts
+skipCache(): this
+```
+
+Skip cache for all subsequent build instructions from this point.
+
+###### Returns
+
+`this`
+
+###### Example
+
+```ts
+Template().skipCache().fromPythonImage('3')
+```
+
+###### Implementation of
+
+`TemplateBuilder`.`skipCache`
+
+### aliasExists()
+
+```ts
+static aliasExists(alias: string, options?: ConnectionOpts): Promise<boolean>
+```
+
+Check if a template with the given alias exists.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `alias` | `string` | Template alias to check |
+| `options`? | `ConnectionOpts` | Authentication options |
+
+###### Returns
+
+`Promise`\<`boolean`\>
+
+True if the alias exists, false otherwise
+
+###### Example
+
+```ts
+const exists = await Template.aliasExists('my-python-env')
+if (exists) {
+ console.log('Template exists!')
+}
+```
+
+### assignTags()
+
+```ts
+static assignTags(
+ targetName: string,
+ tags: string | string[],
+options?: ConnectionOpts): Promise<TemplateTagInfo>
+```
+
+Assign tag(s) to an existing template build.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `targetName` | `string` | Template name in 'name:tag' format (the source build to tag from) |
+| `tags` | `string` \| `string`[] | Tag or tags to assign |
+| `options`? | `ConnectionOpts` | Authentication options |
+
+###### Returns
+
+`Promise`\<`TemplateTagInfo`\>
+
+Tag info with buildId and assigned tags
+
+###### Example
+
+```ts
+// Assign a single tag
+await Template.assignTags('my-template:v1.0', 'production')
+
+// Assign multiple tags
+await Template.assignTags('my-template:v1.0', ['production', 'stable'])
+```
+
+### build()
+
+###### build(template, name, options)
+
+```ts
+static build(
+ template: TemplateClass,
+ name: string,
+options?: Omit<BuildOptions, "alias">): Promise<BuildInfo>
+```
+
+Build and deploy a template to E2B infrastructure.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `template` | `TemplateClass` | The template to build |
+| `name` | `string` | Template name in 'name' or 'name:tag' format |
+| `options`? | `Omit`\<`BuildOptions`, `"alias"`\> | Optional build configuration options |
+
+###### Returns
+
+`Promise`\<`BuildInfo`\>
+
+###### Example
+
+```ts
+const template = Template().fromPythonImage('3')
+
+// Build with single tag in name
+await Template.build(template, 'my-python-env:v1.0')
+
+// Build with multiple tags
+await Template.build(template, 'my-python-env', { tags: ['v1.0', 'stable'] })
+```
+
+###### build(template, options)
+
+```ts
+static build(template: TemplateClass, options: BuildOptions): Promise<BuildInfo>
+```
+
+Build and deploy a template to E2B infrastructure.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `template` | `TemplateClass` | The template to build |
+| `options` | `BuildOptions` | Build configuration options with alias (deprecated) |
+
+###### Returns
+
+`Promise`\<`BuildInfo`\>
+
+###### Deprecated
+
+Use the overload with `name` parameter instead.
+
+###### Example
+
+```ts
+// Deprecated:
+await Template.build(template, { alias: 'my-python-env' })
+
+// Use instead:
+await Template.build(template, 'my-python-env:v1.0')
+```
+
+### buildInBackground()
+
+###### buildInBackground(template, name, options)
+
+```ts
+static buildInBackground(
+ template: TemplateClass,
+ name: string,
+options?: Omit<BuildOptions, "alias">): Promise<BuildInfo>
+```
+
+Build and deploy a template to E2B infrastructure without waiting for completion.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `template` | `TemplateClass` | The template to build |
+| `name` | `string` | Template name in 'name' or 'name:tag' format |
+| `options`? | `Omit`\<`BuildOptions`, `"alias"`\> | Optional build configuration options |
+
+###### Returns
+
+`Promise`\<`BuildInfo`\>
+
+###### Example
+
+```ts
+const template = Template().fromPythonImage('3')
+
+// Build with single tag in name
+const data = await Template.buildInBackground(template, 'my-python-env:v1.0')
+
+// Build with multiple tags
+const data = await Template.buildInBackground(template, 'my-python-env', { tags: ['v1.0', 'stable'] })
+```
+
+###### buildInBackground(template, options)
+
+```ts
+static buildInBackground(template: TemplateClass, options: BuildOptions): Promise<BuildInfo>
+```
+
+Build and deploy a template to E2B infrastructure without waiting for completion.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `template` | `TemplateClass` | The template to build |
+| `options` | `BuildOptions` | Build configuration options with alias (deprecated) |
+
+###### Returns
+
+`Promise`\<`BuildInfo`\>
+
+###### Deprecated
+
+Use the overload with `name` parameter instead.
+
+###### Example
+
+```ts
+// Deprecated:
+await Template.buildInBackground(template, { alias: 'my-python-env' })
+
+// Use instead:
+await Template.buildInBackground(template, 'my-python-env:v1.0')
+```
+
+### getBuildStatus()
+
+```ts
+static getBuildStatus(data: Pick<BuildInfo, "buildId" | "templateId">, options?: GetBuildStatusOptions): Promise<TemplateBuildStatusResponse>
+```
+
+Get the status of a build.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `data` | `Pick`\<`BuildInfo`, `"buildId"` \| `"templateId"`\> | Build identifiers |
+| `options`? | `GetBuildStatusOptions` | Authentication options |
+
+###### Returns
+
+`Promise`\<`TemplateBuildStatusResponse`\>
+
+###### Example
+
+```ts
+const status = await Template.getBuildStatus(data, { logsOffset: 0 })
+```
+
+### removeTags()
+
+```ts
+static removeTags(
+ name: string,
+ tags: string | string[],
+options?: ConnectionOpts): Promise<void>
+```
+
+Remove tag(s) from a template.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `name` | `string` | Template name |
+| `tags` | `string` \| `string`[] | Tag or tags to remove |
+| `options`? | `ConnectionOpts` | Authentication options |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+###### Example
+
+```ts
+// Remove a single tag
+await Template.removeTags('my-template', 'production')
+
+// Remove multiple tags from a template
+await Template.removeTags('my-template', ['production', 'staging'])
+```
+
+### toDockerfile()
+
+```ts
+static toDockerfile(template: TemplateClass): string
+```
+
+Convert a template to Dockerfile format.
+Note: Templates based on other E2B templates cannot be converted to Dockerfile.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `template` | `TemplateClass` | The template to convert |
+
+###### Returns
+
+`string`
+
+Dockerfile string representation
+
+###### Throws
+
+Error if the template is based on another E2B template
+
+### toJSON()
+
+```ts
+static toJSON(template: TemplateClass, computeHashes: boolean): Promise<string>
+```
+
+Convert a template to JSON representation.
+
+###### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `template` | `TemplateClass` | `undefined` | The template to convert |
+| `computeHashes` | `boolean` | `true` | Whether to compute file hashes for cache invalidation |
+
+###### Returns
+
+`Promise`\<`string`\>
+
+JSON string representation of the template
+
+## Interfaces
+
+### TemplateBuilder
+
+Main builder state for constructing templates.
+Provides methods for customizing the template environment.
+
+#### Methods
+
+### addMcpServer()
+
+```ts
+addMcpServer(servers: keyof McpServer | keyof McpServer[]): TemplateBuilder
+```
+
+Install MCP servers using mcp-gateway.
+Note: Requires a base image with mcp-gateway pre-installed (e.g., mcp-gateway).
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `servers` | keyof McpServer \| keyof McpServer[] | MCP server name(s) |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Throws
+
+If the base template is not mcp-gateway
+
+###### Example
+
+```ts
+template.addMcpServer('exa')
+template.addMcpServer(['brave', 'firecrawl', 'duckduckgo'])
+```
+
+### aptInstall()
+
+```ts
+aptInstall(packages: string | string[], options?: object): TemplateBuilder
+```
+
+Install Debian/Ubuntu packages using apt-get.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages` | `string` \| `string`[] | Package name(s) |
+| `options`? | `object` | - |
+| `options.noInstallRecommends`? | `boolean` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.aptInstall('vim')
+template.aptInstall(['git', 'curl', 'wget'])
+template.aptInstall(['vim'], { noInstallRecommends: true })
+```
+
+### betaDevContainerPrebuild()
+
+```ts
+betaDevContainerPrebuild(devcontainerDirectory: string): TemplateBuilder
+```
+
+Prebuild a devcontainer from the specified directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `devcontainerDirectory` | `string` | Path to the devcontainer directory |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template
+ .gitClone('https://myrepo.com/project.git', '/my-devcontainer')
+ .betaDevContainerPrebuild('/my-devcontainer')
+```
+
+### betaSetDevContainerStart()
+
+```ts
+betaSetDevContainerStart(devcontainerDirectory: string): TemplateFinal
+```
+
+Start a devcontainer from the specified directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `devcontainerDirectory` | `string` | Path to the devcontainer directory |
+
+###### Returns
+
+`TemplateFinal`
+
+###### Example
+
+```ts
+template
+ .gitClone('https://myrepo.com/project.git', '/my-devcontainer')
+ .startDevcontainer('/my-devcontainer')
+
+// Prebuild and start
+template
+ .gitClone('https://myrepo.com/project.git', '/my-devcontainer')
+ .betaDevContainerPrebuild('/my-devcontainer')
+ // Other instructions...
+ .betaSetDevContainerStart('/my-devcontainer')
+```
+
+### bunInstall()
+
+```ts
+bunInstall(packages?: string | string[], options?: object): TemplateBuilder
+```
+
+Install Bun packages using bun.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages`? | `string` \| `string`[] | Package name(s) or undefined for package.json |
+| `options`? | `object` | Install options |
+| `options.dev`? | `boolean` | - |
+| `options.g`? | `boolean` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.bunInstall('express')
+template.bunInstall(['lodash', 'axios'])
+template.bunInstall('tsx', { g: true })
+template.bunInstall('typescript', { dev: true })
+template.bunInstall() // Installs from package.json
+```
+
+### copy()
+
+```ts
+copy(
+ src: PathLike | PathLike[],
+ dest: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Copy files or directories into the template.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `src` | `PathLike` \| `PathLike`[] | Source path(s) |
+| `dest` | `PathLike` | Destination path |
+| `options`? | `object` | Copy options |
+| `options.forceUpload`? | `true` | - |
+| `options.mode`? | `number` | - |
+| `options.resolveSymlinks`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.copy('requirements.txt', '/home/user/')
+template.copy(['app.ts', 'config.ts'], '/app/', { mode: 0o755 })
+```
+
+### copyItems()
+
+```ts
+copyItems(items: CopyItem[]): TemplateBuilder
+```
+
+Copy multiple items with individual options.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `items` | `CopyItem`[] | Array of copy items |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.copyItems([
+ { src: 'app.ts', dest: '/app/' },
+ { src: 'config.ts', dest: '/app/', mode: 0o644 }
+])
+```
+
+### gitClone()
+
+```ts
+gitClone(
+ url: string,
+ path?: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Clone a Git repository.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `url` | `string` | Repository URL |
+| `path`? | `PathLike` | Optional destination path |
+| `options`? | `object` | Clone options |
+| `options.branch`? | `string` | - |
+| `options.depth`? | `number` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.gitClone('https://github.com/user/repo.git', '/app/repo')
+template.gitClone('https://github.com/user/repo.git', undefined, {
+ branch: 'main',
+ depth: 1
+})
+template.gitClone('https://github.com/user/repo.git', '/app/repo', {
+ user: 'root'
+})
+```
+
+### makeDir()
+
+```ts
+makeDir(path: PathLike | PathLike[], options?: object): TemplateBuilder
+```
+
+Create directories.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `PathLike` \| `PathLike`[] | Directory path(s) |
+| `options`? | `object` | Directory options |
+| `options.mode`? | `number` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.makeDir('/app/data', { mode: 0o755 })
+template.makeDir(['/app/logs', '/app/cache'])
+template.makeDir('/app/data', { mode: 0o755, user: 'root' })
+```
+
+### makeSymlink()
+
+```ts
+makeSymlink(
+ src: PathLike,
+ dest: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Create a symbolic link.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `src` | `PathLike` | Source path (target) |
+| `dest` | `PathLike` | Destination path (symlink location) |
+| `options`? | `object` | Symlink options |
+| `options.force`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.makeSymlink('/usr/bin/python3', '/usr/bin/python')
+template.makeSymlink('/usr/bin/python3', '/usr/bin/python', { user: 'root' })
+template.makeSymlink('/usr/bin/python3', '/usr/bin/python', { force: true })
+```
+
+### npmInstall()
+
+```ts
+npmInstall(packages?: string | string[], options?: object): TemplateBuilder
+```
+
+Install Node.js packages using npm.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages`? | `string` \| `string`[] | Package name(s) or undefined for package.json |
+| `options`? | `object` | Install options |
+| `options.dev`? | `boolean` | - |
+| `options.g`? | `boolean` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.npmInstall('express')
+template.npmInstall(['lodash', 'axios'])
+template.npmInstall('tsx', { g: true })
+template.npmInstall('typescript', { dev: true })
+template.npmInstall() // Installs from package.json
+```
+
+### pipInstall()
+
+```ts
+pipInstall(packages?: string | string[], options?: object): TemplateBuilder
+```
+
+Install Python packages using pip.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `packages`? | `string` \| `string`[] | Package name(s) or undefined for current directory |
+| `options`? | `object` | Install options |
+| `options.g`? | `boolean` | Install globally as root (default: true). Set to false for user-only installation with --user flag |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.pipInstall('numpy') // Installs globally (default)
+template.pipInstall(['pandas', 'scikit-learn'])
+template.pipInstall('numpy', { g: false }) // Install for user only
+template.pipInstall() // Installs from current directory
+```
+
+### remove()
+
+```ts
+remove(path: PathLike | PathLike[], options?: object): TemplateBuilder
+```
+
+Remove files or directories.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `path` | `PathLike` \| `PathLike`[] | Path(s) to remove |
+| `options`? | `object` | Remove options |
+| `options.force`? | `boolean` | - |
+| `options.recursive`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.remove('/tmp/cache', { recursive: true, force: true })
+template.remove('/tmp/cache', { recursive: true, force: true, user: 'root' })
+```
+
+### rename()
+
+```ts
+rename(
+ src: PathLike,
+ dest: PathLike,
+ options?: object): TemplateBuilder
+```
+
+Rename or move a file or directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `src` | `PathLike` | Source path |
+| `dest` | `PathLike` | Destination path |
+| `options`? | `object` | Rename options |
+| `options.force`? | `boolean` | - |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.rename('/tmp/old.txt', '/tmp/new.txt')
+template.rename('/tmp/old.txt', '/tmp/new.txt', { user: 'root' })
+```
+
+### runCmd()
+
+###### runCmd(command, options)
+
+```ts
+runCmd(command: string, options?: object): TemplateBuilder
+```
+
+Run a shell command.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `command` | `string` | Command string |
+| `options`? | `object` | Command options |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.runCmd('apt-get update')
+template.runCmd(['pip install numpy', 'pip install pandas'])
+template.runCmd('apt-get install vim', { user: 'root' })
+```
+
+###### runCmd(commands, options)
+
+```ts
+runCmd(commands: string[], options?: object): TemplateBuilder
+```
+
+Run multiple shell commands.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `commands` | `string`[] | Array of command strings |
+| `options`? | `object` | Command options |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### runCmd(commandOrCommands, options)
+
+```ts
+runCmd(commandOrCommands: string | string[], options?: object): TemplateBuilder
+```
+
+Run command(s).
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `commandOrCommands` | `string` \| `string`[] | Command or commands |
+| `options`? | `object` | Command options |
+| `options.user`? | `string` | - |
+
+###### Returns
+
+`TemplateBuilder`
+
+### setEnvs()
+
+```ts
+setEnvs(envs: Record<string, string>): TemplateBuilder
+```
+
+Set environment variables.
+Note: Environment variables defined here are available only during template build.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `envs` | `Record`\<`string`, `string`\> | Environment variables |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.setEnvs({ NODE_ENV: 'production', PORT: '8080' })
+```
+
+### setReadyCmd()
+
+```ts
+setReadyCmd(readyCommand: string | ReadyCmd): TemplateFinal
+```
+
+Set or update the ready check command.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `readyCommand` | `string` \| `ReadyCmd` | Command to check readiness |
+
+###### Returns
+
+`TemplateFinal`
+
+###### Example
+
+```ts
+// Using a string command
+template.setReadyCmd('curl http://localhost:8000/health')
+
+// Using ReadyCmd helpers
+import { waitForPort, waitForFile, waitForProcess } from 'e2b'
+
+template.setReadyCmd(waitForPort(3000))
+
+template.setReadyCmd(waitForFile('/tmp/ready'))
+
+template.setReadyCmd(waitForProcess('nginx'))
+```
+
+### setStartCmd()
+
+```ts
+setStartCmd(startCommand: string, readyCommand: string | ReadyCmd): TemplateFinal
+```
+
+Set the start command and ready check.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `startCommand` | `string` | Command to run on startup |
+| `readyCommand` | `string` \| `ReadyCmd` | Command to check readiness |
+
+###### Returns
+
+`TemplateFinal`
+
+###### Example
+
+```ts
+// Using a string command
+template.setStartCmd(
+ 'node app.js',
+ 'curl http://localhost:8000/health'
+)
+
+// Using ReadyCmd helpers
+import { waitForPort, waitForURL } from 'e2b'
+
+template.setStartCmd(
+ 'python -m http.server 8000',
+ waitForPort(8000)
+)
+
+template.setStartCmd(
+ 'npm start',
+ waitForURL('http://localhost:3000/health', 200)
+)
+```
+
+### setUser()
+
+```ts
+setUser(user: string): TemplateBuilder
+```
+
+Set the user for subsequent commands.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `user` | `string` | Username |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.setUser('root')
+```
+
+### setWorkdir()
+
+```ts
+setWorkdir(workdir: PathLike): TemplateBuilder
+```
+
+Set the working directory.
+
+###### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `workdir` | `PathLike` | Working directory path |
+
+###### Returns
+
+`TemplateBuilder`
+
+###### Example
+
+```ts
+template.setWorkdir('/app')
+```
+
+### skipCache()
+
+```ts
+skipCache(): this
+```
+
+Skip cache for all subsequent build instructions from this point.
+
+###### Returns
+
+`this`
+
+###### Example
+
+```ts
+template.skipCache().runCmd('apt-get update')
+```
+
+## Type Aliases
+
+### AliasExistsOptions
+
+```ts
+type AliasExistsOptions: ConnectionOpts;
+```
+
+Options for checking if a template alias exists.
+
+***
+
+### BuildInfo
+
+```ts
+type BuildInfo: object;
+```
+
+Information about a built template.
+
+#### Type declaration
+
+| Name | Type | Description |
+| ------ | ------ | ------ |
+| `alias` | `string` | First alias from the build (for backward compatibility). **Deprecated** Use `name` instead. |
+| `buildId` | `string` | Build identifier. |
+| `name` | `string` | Name of the template. |
+| `tags` | `string`[] | Tags assigned to this build. |
+| `templateId` | `string` | Template identifier. |
+
+***
+
+### BuildOptions
+
+```ts
+type BuildOptions: ConnectionOpts & BasicBuildOptions;
+```
+
+Options for building a template with authentication.
+
+***
+
+### BuildStatusReason
+
+```ts
+type BuildStatusReason: object;
+```
+
+Reason for the current build status (typically for errors).
+
+#### Type declaration
+
+| Name | Type | Description |
+| ------ | ------ | ------ |
+| `logEntries` | `LogEntry`[] | Log entries related to the status reason. |
+| `message` | `string` | Message with the status reason. |
+| `step`? | `string` | Step that failed. |
+
+***
+
+### CopyItem
+
+```ts
+type CopyItem: object;
+```
+
+Configuration for a single file/directory copy operation.
+
+#### Type declaration
+
+| Name | Type |
+| ------ | ------ |
+| `dest` | `PathLike` |
+| `forceUpload`? | `true` |
+| `mode`? | `number` |
+| `resolveSymlinks`? | `boolean` |
+| `src` | `PathLike` \| `PathLike`[] |
+| `user`? | `string` |
+
+***
+
+### GetBuildStatusOptions
+
+```ts
+type GetBuildStatusOptions: ConnectionOpts & object;
+```
+
+Options for getting build status.
+
+#### Type declaration
+
+| Name | Type |
+| ------ | ------ |
+| `logsOffset`? | `number` |
+
+***
+
+### McpServerName
+
+```ts
+type McpServerName: keyof McpServer;
+```
+
+MCP server names that can be installed.
+
+***
+
+### TemplateBuildStatus
+
+```ts
+type TemplateBuildStatus: "building" | "waiting" | "ready" | "error";
+```
+
+Status of a template build.
+
+***
+
+### TemplateBuildStatusResponse
+
+```ts
+type TemplateBuildStatusResponse: object;
+```
+
+Response from getting build status.
+
+#### Type declaration
+
+| Name | Type | Description |
+| ------ | ------ | ------ |
+| `buildID` | `string` | Build identifier. |
+| `logEntries` | `LogEntry`[] | Build log entries. |
+| `logs` | `string`[] | Build logs (raw strings). **Deprecated** Use `logEntries` instead. |
+| `reason`? | `BuildStatusReason` | Reason for the current status (typically for errors). |
+| `status` | `TemplateBuildStatus` | Current status of the build. |
+| `templateID` | `string` | Template identifier. |
+
+***
+
+### TemplateClass
+
+```ts
+type TemplateClass: TemplateBuilder | TemplateFinal;
+```
+
+Type representing a template in any state (builder or final).
+
+***
+
+### TemplateTagInfo
+
+```ts
+type TemplateTagInfo: object;
+```
+
+Information about assigned template tags.
+
+#### Type declaration
+
+| Name | Type | Description |
+| ------ | ------ | ------ |
+| `buildId` | `string` | Build identifier associated with this tag. |
+| `tags` | `string`[] | Assigned tags of the template. |
+
+## Functions
+
+### Template()
+
+```ts
+function Template(options?: TemplateOptions): TemplateFromImage
+```
+
+Create a new E2B template builder instance.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options`? | `TemplateOptions` | Optional configuration for the template builder |
+
+#### Returns
+
+`TemplateFromImage`
+
+A new template builder instance
+
+#### Example
+
+```ts
+import { Template } from 'e2b'
+
+const template = Template()
+ .fromPythonImage('3')
+ .copy('requirements.txt', '/app/')
+ .pipInstall()
+
+await Template.build(template, 'my-python-app:v1.0')
+```
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/readycmd/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/readycmd/page.mdx
new file mode 100644
index 000000000..d9f157dbf
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/js-sdk/v2.11.0/template/readycmd/page.mdx
@@ -0,0 +1,197 @@
+### ReadyCmd
+
+Class for ready check commands.
+
+#### Constructors
+
+```ts
+new ReadyCmd(cmd: string): ReadyCmd
+```
+
+###### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `cmd` | `string` |
+
+###### Returns
+
+`ReadyCmd`
+
+#### Methods
+
+### getCmd()
+
+```ts
+getCmd(): string
+```
+
+###### Returns
+
+`string`
+
+## Functions
+
+### waitForFile()
+
+```ts
+function waitForFile(filename: string): ReadyCmd
+```
+
+Wait for a file to exist.
+Uses shell test command to check file existence.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `filename` | `string` | Path to the file to wait for |
+
+#### Returns
+
+`ReadyCmd`
+
+ReadyCmd that checks for the file
+
+#### Example
+
+```ts
+import { Template, waitForFile } from 'e2b'
+
+const template = Template()
+ .fromBaseImage()
+ .setStartCmd('./init.sh', waitForFile('/tmp/ready'))
+```
+
+***
+
+### waitForPort()
+
+```ts
+function waitForPort(port: number): ReadyCmd
+```
+
+Wait for a port to be listening.
+Uses `ss` command to check if a port is open and listening.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `port` | `number` | Port number to wait for |
+
+#### Returns
+
+`ReadyCmd`
+
+ReadyCmd that checks for the port
+
+#### Example
+
+```ts
+import { Template, waitForPort } from 'e2b'
+
+const template = Template()
+ .fromPythonImage()
+ .setStartCmd('python -m http.server 8000', waitForPort(8000))
+```
+
+***
+
+### waitForProcess()
+
+```ts
+function waitForProcess(processName: string): ReadyCmd
+```
+
+Wait for a process with a specific name to be running.
+Uses `pgrep` to check if a process exists.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `processName` | `string` | Name of the process to wait for |
+
+#### Returns
+
+`ReadyCmd`
+
+ReadyCmd that checks for the process
+
+#### Example
+
+```ts
+import { Template, waitForProcess } from 'e2b'
+
+const template = Template()
+ .fromBaseImage()
+ .setStartCmd('./my-daemon', waitForProcess('my-daemon'))
+```
+
+***
+
+### waitForTimeout()
+
+```ts
+function waitForTimeout(timeout: number): ReadyCmd
+```
+
+Wait for a specified timeout before considering the sandbox ready.
+Uses `sleep` command to wait for a fixed duration.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `timeout` | `number` | Time to wait in milliseconds (minimum: 1000ms / 1 second) |
+
+#### Returns
+
+`ReadyCmd`
+
+ReadyCmd that waits for the specified duration
+
+#### Example
+
+```ts
+import { Template, waitForTimeout } from 'e2b'
+
+const template = Template()
+ .fromNodeImage()
+ .setStartCmd('npm start', waitForTimeout(5000)) // Wait 5 seconds
+```
+
+***
+
+### waitForURL()
+
+```ts
+function waitForURL(url: string, statusCode: number): ReadyCmd
+```
+
+Wait for a URL to return a specific HTTP status code.
+Uses `curl` to make HTTP requests and check the response status.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `url` | `string` | `undefined` | URL to check (e.g., 'http://localhost:3000/health') |
+| `statusCode` | `number` | `200` | Expected HTTP status code (default: 200) |
+
+#### Returns
+
+`ReadyCmd`
+
+ReadyCmd that checks the URL
+
+#### Example
+
+```ts
+import { Template, waitForURL } from 'e2b'
+
+const template = Template()
+ .fromNodeImage()
+ .setStartCmd('npm start', waitForURL('http://localhost:3000/health'))
+```
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/exceptions/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/exceptions/page.mdx
new file mode 100644
index 000000000..28991790d
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/exceptions/page.mdx
@@ -0,0 +1,102 @@
+
+
+
+## SandboxException
+
+```python
+class SandboxException(Exception)
+```
+
+Base class for all sandbox errors.
+
+Raised when a general sandbox exception occurs.
+
+
+## TimeoutException
+
+```python
+class TimeoutException(SandboxException)
+```
+
+Raised when a timeout occurs.
+
+The `unavailable` exception type is caused by sandbox timeout.
+
+The `canceled` exception type is caused by exceeding request timeout.
+
+The `deadline_exceeded` exception type is caused by exceeding the timeout for process, watch, etc.
+
+The `unknown` exception type is sometimes caused by the sandbox timeout when the request is not processed correctly.
+
+
+## InvalidArgumentException
+
+```python
+class InvalidArgumentException(SandboxException)
+```
+
+Raised when an invalid argument is provided.
+
+
+## NotEnoughSpaceException
+
+```python
+class NotEnoughSpaceException(SandboxException)
+```
+
+Raised when there is not enough disk space.
+
+
+## NotFoundException
+
+```python
+class NotFoundException(SandboxException)
+```
+
+Raised when a resource is not found.
+
+
+## AuthenticationException
+
+```python
+class AuthenticationException(Exception)
+```
+
+Raised when authentication fails.
+
+
+## TemplateException
+
+```python
+class TemplateException(SandboxException)
+```
+
+Exception raised when the template uses old envd version. It isn't compatible with the new SDK.
+
+
+## RateLimitException
+
+```python
+class RateLimitException(SandboxException)
+```
+
+Raised when the API rate limit is exceeded.
+
+
+## BuildException
+
+```python
+class BuildException(Exception)
+```
+
+Raised when the build fails.
+
+
+## FileUploadException
+
+```python
+class FileUploadException(BuildException)
+```
+
+Raised when the file upload fails.
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/sandbox_async/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/sandbox_async/page.mdx
new file mode 100644
index 000000000..39d64e82b
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/sandbox_async/page.mdx
@@ -0,0 +1,1328 @@
+
+
+
+## AsyncCommandHandle
+
+```python
+class AsyncCommandHandle()
+```
+
+Command execution handle.
+
+It provides methods for waiting for the command to finish, retrieving stdout/stderr, and killing the command.
+
+
+### pid
+
+```python
+@property
+def pid()
+```
+
+Command process ID.
+
+
+### stdout
+
+```python
+@property
+def stdout()
+```
+
+Command stdout output.
+
+
+### stderr
+
+```python
+@property
+def stderr()
+```
+
+Command stderr output.
+
+
+### error
+
+```python
+@property
+def error()
+```
+
+Command execution error message.
+
+
+### exit\_code
+
+```python
+@property
+def exit_code()
+```
+
+Command execution exit code.
+
+`0` if the command finished successfully.
+
+It is `None` if the command is still running.
+
+
+### disconnect
+
+```python
+async def disconnect() -> None
+```
+
+Disconnects from the command.
+
+The command is not killed, but SDK stops receiving events from the command.
+You can reconnect to the command using `sandbox.commands.connect` method.
+
+
+### wait
+
+```python
+async def wait() -> CommandResult
+```
+
+Wait for the command to finish and return the result.
+
+If the command exits with a non-zero exit code, it throws a `CommandExitException`.
+
+**Returns**:
+
+`CommandResult` result of command execution
+
+
+### kill
+
+```python
+async def kill() -> bool
+```
+
+Kills the command.
+
+It uses `SIGKILL` signal to kill the command
+
+**Returns**:
+
+`True` if the command was killed successfully, `False` if the command was not found
+
+
+
+
+## Pty
+
+```python
+class Pty()
+```
+
+Module for interacting with PTYs (pseudo-terminals) in the sandbox.
+
+
+### kill
+
+```python
+async def kill(pid: int, request_timeout: Optional[float] = None) -> bool
+```
+
+Kill PTY.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`true` if the PTY was killed, `false` if the PTY was not found
+
+
+### send\_stdin
+
+```python
+async def send_stdin(pid: int,
+ data: bytes,
+ request_timeout: Optional[float] = None) -> None
+```
+
+Send input to a PTY.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY
+- `data`: Input data to send
+- `request_timeout`: Timeout for the request in **seconds**
+
+
+### create
+
+```python
+async def create(
+ size: PtySize,
+ on_data: OutputHandler[PtyOutput],
+ user: Optional[Username] = None,
+ cwd: Optional[str] = None,
+ envs: Optional[Dict[str, str]] = None,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> AsyncCommandHandle
+```
+
+Start a new PTY (pseudo-terminal).
+
+**Arguments**:
+
+- `size`: Size of the PTY
+- `on_data`: Callback to handle PTY data
+- `user`: User to use for the PTY
+- `cwd`: Working directory for the PTY
+- `envs`: Environment variables for the PTY
+- `timeout`: Timeout for the PTY in **seconds**
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Handle to interact with the PTY
+
+
+### connect
+
+```python
+async def connect(
+ pid: int,
+ on_data: OutputHandler[PtyOutput],
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> AsyncCommandHandle
+```
+
+Connect to a running PTY.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY to connect to. You can get the list of running PTYs using `sandbox.pty.list()`.
+- `on_data`: Callback to handle PTY data
+- `timeout`: Timeout for the PTY connection in **seconds**. Using `0` will not limit the connection time
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Handle to interact with the PTY
+
+
+### resize
+
+```python
+async def resize(pid: int,
+ size: PtySize,
+ request_timeout: Optional[float] = None)
+```
+
+Resize PTY.
+
+Call this when the terminal window is resized and the number of columns and rows has changed.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY
+- `size`: New size of the PTY
+- `request_timeout`: Timeout for the request in **seconds**
+
+
+
+
+## Commands
+
+```python
+class Commands()
+```
+
+Module for executing commands in the sandbox.
+
+
+### list
+
+```python
+async def list(request_timeout: Optional[float] = None) -> List[ProcessInfo]
+```
+
+Lists all running commands and PTY sessions.
+
+**Arguments**:
+
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+List of running commands and PTY sessions
+
+
+### kill
+
+```python
+async def kill(pid: int, request_timeout: Optional[float] = None) -> bool
+```
+
+Kill a running command specified by its process ID.
+
+It uses `SIGKILL` signal to kill the command.
+
+**Arguments**:
+
+- `pid`: Process ID of the command. You can get the list of processes using `sandbox.commands.list()`
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the command was killed, `False` if the command was not found
+
+
+### send\_stdin
+
+```python
+async def send_stdin(pid: int,
+ data: str,
+ request_timeout: Optional[float] = None) -> None
+```
+
+Send data to command stdin.
+
+:param pid Process ID of the command. You can get the list of processes using `sandbox.commands.list()`.
+:param data: Data to send to the command
+:param request_timeout: Timeout for the request in **seconds**
+
+
+
+### run
+
+```python
+@overload
+async def run(cmd: str,
+ background: Union[Literal[False], None] = None,
+ envs: Optional[Dict[str, str]] = None,
+ user: Optional[Username] = None,
+ cwd: Optional[str] = None,
+ on_stdout: Optional[OutputHandler[Stdout]] = None,
+ on_stderr: Optional[OutputHandler[Stderr]] = None,
+ stdin: Optional[bool] = None,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> CommandResult
+```
+
+Start a new command and wait until it finishes executing.
+
+**Arguments**:
+
+- `cmd`: Command to execute
+- `background`: **`False` if the command should be executed in the foreground**, `True` if the command should be executed in the background
+- `envs`: Environment variables used for the command
+- `user`: User to run the command as
+- `cwd`: Working directory to run the command
+- `on_stdout`: Callback for command stdout output
+- `on_stderr`: Callback for command stderr output
+- `stdin`: If `True`, the command will have a stdin stream that you can send data to using `sandbox.commands.send_stdin()`
+- `timeout`: Timeout for the command connection in **seconds**. Using `0` will not limit the command connection time
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`CommandResult` result of the command execution
+
+
+### run
+
+```python
+@overload
+async def run(cmd: str,
+ background: Literal[True],
+ envs: Optional[Dict[str, str]] = None,
+ user: Optional[Username] = None,
+ cwd: Optional[str] = None,
+ on_stdout: Optional[OutputHandler[Stdout]] = None,
+ on_stderr: Optional[OutputHandler[Stderr]] = None,
+ stdin: Optional[bool] = None,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> AsyncCommandHandle
+```
+
+Start a new command and return a handle to interact with it.
+
+**Arguments**:
+
+- `cmd`: Command to execute
+- `background`: `False` if the command should be executed in the foreground, **`True` if the command should be executed in the background**
+- `envs`: Environment variables used for the command
+- `user`: User to run the command as
+- `cwd`: Working directory to run the command
+- `on_stdout`: Callback for command stdout output
+- `on_stderr`: Callback for command stderr output
+- `stdin`: If `True`, the command will have a stdin stream that you can send data to using `sandbox.commands.send_stdin()`
+- `timeout`: Timeout for the command connection in **seconds**. Using `0` will not limit the command connection time
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`AsyncCommandHandle` handle to interact with the running command
+
+
+### connect
+
+```python
+async def connect(
+ pid: int,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None,
+ on_stdout: Optional[OutputHandler[Stdout]] = None,
+ on_stderr: Optional[OutputHandler[Stderr]] = None
+) -> AsyncCommandHandle
+```
+
+Connects to a running command.
+
+You can use `AsyncCommandHandle.wait()` to wait for the command to finish and get execution results.
+
+**Arguments**:
+
+- `pid`: Process ID of the command to connect to. You can get the list of processes using `sandbox.commands.list()`
+- `request_timeout`: Request timeout in **seconds**
+- `timeout`: Timeout for the command connection in **seconds**. Using `0` will not limit the command connection time
+- `on_stdout`: Callback for command stdout output
+- `on_stderr`: Callback for command stderr output
+
+**Returns**:
+
+`AsyncCommandHandle` handle to interact with the running command
+
+
+
+
+## SandboxApi
+
+```python
+class SandboxApi(SandboxBase)
+```
+
+
+### list
+
+```python
+@staticmethod
+def list(query: Optional[SandboxQuery] = None,
+ limit: Optional[int] = None,
+ next_token: Optional[str] = None,
+ **opts: Unpack[ApiParams]) -> AsyncSandboxPaginator
+```
+
+List all running sandboxes.
+
+**Arguments**:
+
+- `query`: Filter the list of sandboxes by metadata or state, e.g. `SandboxListQuery(metadata={"key": "value"})` or `SandboxListQuery(state=[SandboxState.RUNNING])`
+- `limit`: Maximum number of sandboxes to return per page
+- `next_token`: Token for pagination
+
+**Returns**:
+
+List of running sandboxes
+
+
+
+
+## AsyncSandbox
+
+```python
+class AsyncSandbox(SandboxApi)
+```
+
+E2B cloud sandbox is a secure and isolated cloud environment.
+
+The sandbox allows you to:
+- Access Linux OS
+- Create, list, and delete files and directories
+- Run commands
+- Run isolated code
+- Access the internet
+
+Check docs [here](https://e2b.dev/docs).
+
+Use the `AsyncSandbox.create()` to create a new sandbox.
+
+**Example**:
+
+```python
+from e2b import AsyncSandbox
+
+sandbox = await AsyncSandbox.create()
+```
+
+
+### files
+
+```python
+@property
+def files() -> Filesystem
+```
+
+Module for interacting with the sandbox filesystem.
+
+
+### commands
+
+```python
+@property
+def commands() -> Commands
+```
+
+Module for running commands in the sandbox.
+
+
+### pty
+
+```python
+@property
+def pty() -> Pty
+```
+
+Module for interacting with the sandbox pseudo-terminal.
+
+
+### \_\_init\_\_
+
+```python
+def __init__(**opts: Unpack[SandboxOpts])
+```
+
+Use `AsyncSandbox.create()` to create a new sandbox instead.
+
+
+### is\_running
+
+```python
+async def is_running(request_timeout: Optional[float] = None) -> bool
+```
+
+Check if the sandbox is running.
+
+**Arguments**:
+
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the sandbox is running, `False` otherwise
+Example
+```python
+sandbox = await AsyncSandbox.create()
+await sandbox.is_running() # Returns True
+
+await sandbox.kill()
+await sandbox.is_running() # Returns False
+```
+
+
+### create
+
+```python
+@classmethod
+async def create(cls,
+ template: Optional[str] = None,
+ timeout: Optional[int] = None,
+ metadata: Optional[Dict[str, str]] = None,
+ envs: Optional[Dict[str, str]] = None,
+ secure: bool = True,
+ allow_internet_access: bool = True,
+ mcp: Optional[McpServer] = None,
+ network: Optional[SandboxNetworkOpts] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+Create a new sandbox.
+
+By default, the sandbox is created from the default `base` sandbox template.
+
+**Arguments**:
+
+- `template`: Sandbox template name or ID
+- `timeout`: Timeout for the sandbox in **seconds**, default to 300 seconds. The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+- `metadata`: Custom metadata for the sandbox
+- `envs`: Custom environment variables for the sandbox
+- `secure`: Envd is secured with access token and cannot be used without it, defaults to `True`.
+- `allow_internet_access`: Allow sandbox to access the internet, defaults to `True`. If set to `False`, it works the same as setting network `deny_out` to `[0.0.0.0/0]`.
+- `mcp`: MCP server to enable in the sandbox
+- `network`: Sandbox network configuration
+
+**Returns**:
+
+A Sandbox instance for the new sandbox
+Use this method instead of using the constructor to create a new sandbox.
+
+
+### connect
+
+```python
+@overload
+async def connect(timeout: Optional[int] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**
+For running sandboxes, the timeout will update only if the new timeout is longer than the existing one.
+
+**Returns**:
+
+A running sandbox instance
+@example
+```python
+sandbox = await AsyncSandbox.create()
+await sandbox.beta_pause()
+
+same_sandbox = await sandbox.connect()
+```
+
+
+### connect
+
+```python
+@overload
+@classmethod
+async def connect(cls,
+ sandbox_id: str,
+ timeout: Optional[int] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+- `timeout`: Timeout for the sandbox in **seconds**
+For running sandboxes, the timeout will update only if the new timeout is longer than the existing one.
+
+**Returns**:
+
+A running sandbox instance
+@example
+```python
+sandbox = await AsyncSandbox.create()
+await AsyncSandbox.beta_pause(sandbox.sandbox_id)
+
+same_sandbox = await AsyncSandbox.connect(sandbox.sandbox_id))
+```
+
+
+### connect
+
+```python
+@class_method_variant("_cls_connect")
+async def connect(timeout: Optional[int] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**
+For running sandboxes, the timeout will update only if the new timeout is longer than the existing one.
+
+**Returns**:
+
+A running sandbox instance
+@example
+```python
+sandbox = await AsyncSandbox.create()
+await sandbox.beta_pause()
+
+same_sandbox = await sandbox.connect()
+```
+
+
+### kill
+
+```python
+@overload
+async def kill(**opts: Unpack[ApiParams]) -> bool
+```
+
+Kill the sandbox.
+
+**Returns**:
+
+`True` if the sandbox was killed, `False` if the sandbox was not found
+
+
+### kill
+
+```python
+@overload
+@staticmethod
+async def kill(sandbox_id: str, **opts: Unpack[ApiParams]) -> bool
+```
+
+Kill the sandbox specified by sandbox ID.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+
+**Returns**:
+
+`True` if the sandbox was killed, `False` if the sandbox was not found
+
+
+### kill
+
+```python
+@class_method_variant("_cls_kill")
+async def kill(**opts: Unpack[ApiParams]) -> bool
+```
+
+Kill the sandbox specified by sandbox ID.
+
+**Returns**:
+
+`True` if the sandbox was killed, `False` if the sandbox was not found
+
+
+### set\_timeout
+
+```python
+@overload
+async def set_timeout(timeout: int, **opts: Unpack[ApiParams]) -> None
+```
+
+Set the timeout of the sandbox.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to `.set_timeout`.
+
+The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**
+
+
+### set\_timeout
+
+```python
+@overload
+@staticmethod
+async def set_timeout(sandbox_id: str, timeout: int,
+ **opts: Unpack[ApiParams]) -> None
+```
+
+Set the timeout of the specified sandbox.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to `.set_timeout`.
+
+The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+- `timeout`: Timeout for the sandbox in **seconds**
+
+
+### set\_timeout
+
+```python
+@class_method_variant("_cls_set_timeout")
+async def set_timeout(timeout: int, **opts: Unpack[ApiParams]) -> None
+```
+
+Set the timeout of the specified sandbox.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to `.set_timeout`.
+
+The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**
+
+
+### get\_info
+
+```python
+@overload
+async def get_info(**opts: Unpack[ApiParams]) -> SandboxInfo
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+**Returns**:
+
+Sandbox info
+
+
+### get\_info
+
+```python
+@overload
+@staticmethod
+async def get_info(sandbox_id: str, **opts: Unpack[ApiParams]) -> SandboxInfo
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+
+**Returns**:
+
+Sandbox info
+
+
+### get\_info
+
+```python
+@class_method_variant("_cls_get_info")
+async def get_info(**opts: Unpack[ApiParams]) -> SandboxInfo
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+**Returns**:
+
+Sandbox info
+
+
+### get\_metrics
+
+```python
+@overload
+async def get_metrics(start: Optional[datetime.datetime] = None,
+ end: Optional[datetime.datetime] = None,
+ **opts: Unpack[ApiParams]) -> List[SandboxMetrics]
+```
+
+Get the metrics of the current sandbox.
+
+**Arguments**:
+
+- `start`: Start time for the metrics, defaults to the start of the sandbox
+- `end`: End time for the metrics, defaults to the current time
+
+**Returns**:
+
+List of sandbox metrics containing CPU, memory and disk usage information
+
+
+### get\_metrics
+
+```python
+@overload
+@staticmethod
+async def get_metrics(sandbox_id: str,
+ start: Optional[datetime.datetime] = None,
+ end: Optional[datetime.datetime] = None,
+ **opts: Unpack[ApiParams]) -> List[SandboxMetrics]
+```
+
+Get the metrics of the sandbox specified by sandbox ID.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+- `start`: Start time for the metrics, defaults to the start of the sandbox
+- `end`: End time for the metrics, defaults to the current time
+
+**Returns**:
+
+List of sandbox metrics containing CPU, memory and disk usage information
+
+
+### get\_metrics
+
+```python
+@class_method_variant("_cls_get_metrics")
+async def get_metrics(start: Optional[datetime.datetime] = None,
+ end: Optional[datetime.datetime] = None,
+ **opts: Unpack[ApiParams]) -> List[SandboxMetrics]
+```
+
+Get the metrics of the current sandbox.
+
+**Arguments**:
+
+- `start`: Start time for the metrics, defaults to the start of the sandbox
+- `end`: End time for the metrics, defaults to the current time
+
+**Returns**:
+
+List of sandbox metrics containing CPU, memory and disk usage information
+
+
+### beta\_create
+
+```python
+@classmethod
+async def beta_create(cls,
+ template: Optional[str] = None,
+ timeout: Optional[int] = None,
+ auto_pause: bool = False,
+ metadata: Optional[Dict[str, str]] = None,
+ envs: Optional[Dict[str, str]] = None,
+ secure: bool = True,
+ allow_internet_access: bool = True,
+ mcp: Optional[McpServer] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Create a new sandbox.
+
+By default, the sandbox is created from the default `base` sandbox template.
+
+**Arguments**:
+
+- `template`: Sandbox template name or ID
+- `timeout`: Timeout for the sandbox in **seconds**, default to 300 seconds. The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+- `auto_pause`: Automatically pause the sandbox after the timeout expires. Defaults to `False`.
+- `metadata`: Custom metadata for the sandbox
+- `envs`: Custom environment variables for the sandbox
+- `secure`: Envd is secured with access token and cannot be used without it, defaults to `True`.
+- `allow_internet_access`: Allow sandbox to access the internet, defaults to `True`.
+- `mcp`: MCP server to enable in the sandbox
+
+**Returns**:
+
+A Sandbox instance for the new sandbox
+Use this method instead of using the constructor to create a new sandbox.
+
+
+### beta\_pause
+
+```python
+@overload
+async def beta_pause(**opts: Unpack[ApiParams]) -> None
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Pause the sandbox.
+
+**Returns**:
+
+Sandbox ID that can be used to resume the sandbox
+
+
+### beta\_pause
+
+```python
+@overload
+@staticmethod
+async def beta_pause(sandbox_id: str, **opts: Unpack[ApiParams]) -> None
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Pause the sandbox specified by sandbox ID.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+
+**Returns**:
+
+Sandbox ID that can be used to resume the sandbox
+
+
+### beta\_pause
+
+```python
+@class_method_variant("_cls_pause")
+async def beta_pause(**opts: Unpack[ApiParams]) -> None
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Pause the sandbox.
+
+**Returns**:
+
+Sandbox ID that can be used to resume the sandbox
+
+
+### get\_mcp\_token
+
+```python
+async def get_mcp_token() -> Optional[str]
+```
+
+Get the MCP token for the sandbox.
+
+**Returns**:
+
+MCP token for the sandbox, or None if MCP is not enabled.
+
+
+
+
+## Filesystem
+
+```python
+class Filesystem()
+```
+
+Module for interacting with the filesystem in the sandbox.
+
+
+### read
+
+```python
+@overload
+async def read(path: str,
+ format: Literal["text"] = "text",
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> str
+```
+
+Read file content as a `str`.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `user`: Run the operation as this user
+- `format`: Format of the file content—`text` by default
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+File content as a `str`
+
+
+### read
+
+```python
+@overload
+async def read(path: str,
+ format: Literal["bytes"],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> bytearray
+```
+
+Read file content as a `bytearray`.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `user`: Run the operation as this user
+- `format`: Format of the file content—`bytes`
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+File content as a `bytearray`
+
+
+### read
+
+```python
+@overload
+async def read(
+ path: str,
+ format: Literal["stream"],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> AsyncIterator[bytes]
+```
+
+Read file content as a `AsyncIterator[bytes]`.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `user`: Run the operation as this user
+- `format`: Format of the file content—`stream`
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+File content as an `AsyncIterator[bytes]`
+
+
+### write
+
+```python
+async def write(path: str,
+ data: Union[str, bytes, IO],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> WriteInfo
+```
+
+Write content to a file on the path.
+
+Writing to a file that doesn't exist creates the file.
+Writing to a file that already exists overwrites the file.
+Writing to a file at path that doesn't exist creates the necessary directories.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `data`: Data to write to the file, can be a `str`, `bytes`, or `IO`.
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Information about the written file
+
+
+### write\_files
+
+```python
+async def write_files(
+ files: List[WriteEntry],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> List[WriteInfo]
+```
+
+Writes multiple files.
+
+Writes a list of files to the filesystem.
+When writing to a file that doesn't exist, the file will get created.
+When writing to a file that already exists, the file will get overwritten.
+When writing to a file that's in a directory that doesn't exist, you'll get an error.
+
+**Arguments**:
+
+- `files`: list of files to write as `WriteEntry` objects, each containing `path` and `data`
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request
+
+**Returns**:
+
+Information about the written files
+
+
+### list
+
+```python
+async def list(path: str,
+ depth: Optional[int] = 1,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> List[EntryInfo]
+```
+
+List entries in a directory.
+
+**Arguments**:
+
+- `path`: Path to the directory
+- `depth`: Depth of the directory to list
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+List of entries in the directory
+
+
+### exists
+
+```python
+async def exists(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> bool
+```
+
+Check if a file or a directory exists.
+
+**Arguments**:
+
+- `path`: Path to a file or a directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the file or directory exists, `False` otherwise
+
+
+### get\_info
+
+```python
+async def get_info(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> EntryInfo
+```
+
+Get information about a file or directory.
+
+**Arguments**:
+
+- `path`: Path to a file or a directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Information about the file or directory like name, type, and path
+
+
+### remove
+
+```python
+async def remove(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> None
+```
+
+Remove a file or a directory.
+
+**Arguments**:
+
+- `path`: Path to a file or a directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+
+### rename
+
+```python
+async def rename(old_path: str,
+ new_path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> EntryInfo
+```
+
+Rename a file or directory.
+
+**Arguments**:
+
+- `old_path`: Path to the file or directory to rename
+- `new_path`: New path to the file or directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Information about the renamed file or directory
+
+
+### make\_dir
+
+```python
+async def make_dir(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> bool
+```
+
+Create a new directory and all directories along the way if needed on the specified path.
+
+**Arguments**:
+
+- `path`: Path to a new directory. For example '/dirA/dirB' when creating 'dirB'.
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the directory was created, `False` if the directory already exists
+
+
+### watch\_dir
+
+```python
+async def watch_dir(path: str,
+ on_event: OutputHandler[FilesystemEvent],
+ on_exit: Optional[OutputHandler[Exception]] = None,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None,
+ timeout: Optional[float] = 60,
+ recursive: bool = False) -> AsyncWatchHandle
+```
+
+Watch directory for filesystem events.
+
+**Arguments**:
+
+- `path`: Path to a directory to watch
+- `on_event`: Callback to call on each event in the directory
+- `on_exit`: Callback to call when the watching ends
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+- `timeout`: Timeout for the watch operation in **seconds**. Using `0` will not limit the watch time
+- `recursive`: Watch directory recursively
+
+**Returns**:
+
+`AsyncWatchHandle` object for stopping watching directory
+
+
+
+
+## AsyncWatchHandle
+
+```python
+class AsyncWatchHandle()
+```
+
+Handle for watching a directory in the sandbox filesystem.
+
+Use `.stop()` to stop watching the directory.
+
+
+### stop
+
+```python
+async def stop()
+```
+
+Stop watching the directory.
+
+
+
+
+
+
+## AsyncSandboxPaginator
+
+```python
+class AsyncSandboxPaginator(SandboxPaginatorBase)
+```
+
+Paginator for listing sandboxes.
+
+**Example**:
+
+```python
+paginator = AsyncSandbox.list()
+
+while paginator.has_next:
+ sandboxes = await paginator.next_items()
+ print(sandboxes)
+```
+
+
+### next\_items
+
+```python
+async def next_items() -> List[SandboxInfo]
+```
+
+Returns the next page of sandboxes.
+
+Call this method only if `has_next` is `True`, otherwise it will raise an exception.
+
+**Returns**:
+
+List of sandboxes
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/sandbox_sync/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/sandbox_sync/page.mdx
new file mode 100644
index 000000000..c018cd720
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/sandbox_sync/page.mdx
@@ -0,0 +1,1284 @@
+
+
+
+## CommandHandle
+
+```python
+class CommandHandle()
+```
+
+Command execution handle.
+
+It provides methods for waiting for the command to finish, retrieving stdout/stderr, and killing the command.
+
+
+### pid
+
+```python
+@property
+def pid()
+```
+
+Command process ID.
+
+
+### \_\_iter\_\_
+
+```python
+def __iter__()
+```
+
+Iterate over the command output.
+
+**Returns**:
+
+Generator of command outputs
+
+
+### disconnect
+
+```python
+def disconnect() -> None
+```
+
+Disconnect from the command.
+
+The command is not killed, but SDK stops receiving events from the command.
+You can reconnect to the command using `sandbox.commands.connect` method.
+
+
+### wait
+
+```python
+def wait(on_pty: Optional[Callable[[PtyOutput], None]] = None,
+ on_stdout: Optional[Callable[[str], None]] = None,
+ on_stderr: Optional[Callable[[str], None]] = None) -> CommandResult
+```
+
+Wait for the command to finish and returns the result.
+
+If the command exits with a non-zero exit code, it throws a `CommandExitException`.
+
+**Arguments**:
+
+- `on_pty`: Callback for pty output
+- `on_stdout`: Callback for stdout output
+- `on_stderr`: Callback for stderr output
+
+**Returns**:
+
+`CommandResult` result of command execution
+
+
+### kill
+
+```python
+def kill() -> bool
+```
+
+Kills the command.
+
+It uses `SIGKILL` signal to kill the command.
+
+**Returns**:
+
+Whether the command was killed successfully
+
+
+
+
+## Pty
+
+```python
+class Pty()
+```
+
+Module for interacting with PTYs (pseudo-terminals) in the sandbox.
+
+
+### kill
+
+```python
+def kill(pid: int, request_timeout: Optional[float] = None) -> bool
+```
+
+Kill PTY.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`true` if the PTY was killed, `false` if the PTY was not found
+
+
+### send\_stdin
+
+```python
+def send_stdin(pid: int,
+ data: bytes,
+ request_timeout: Optional[float] = None) -> None
+```
+
+Send input to a PTY.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY
+- `data`: Input data to send
+- `request_timeout`: Timeout for the request in **seconds**
+
+
+### create
+
+```python
+def create(size: PtySize,
+ user: Optional[Username] = None,
+ cwd: Optional[str] = None,
+ envs: Optional[Dict[str, str]] = None,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> CommandHandle
+```
+
+Start a new PTY (pseudo-terminal).
+
+**Arguments**:
+
+- `size`: Size of the PTY
+- `user`: User to use for the PTY
+- `cwd`: Working directory for the PTY
+- `envs`: Environment variables for the PTY
+- `timeout`: Timeout for the PTY in **seconds**
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Handle to interact with the PTY
+
+
+### connect
+
+```python
+def connect(pid: int,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> CommandHandle
+```
+
+Connect to a running PTY.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY to connect to. You can get the list of running PTYs using `sandbox.pty.list()`.
+- `timeout`: Timeout for the PTY connection in **seconds**. Using `0` will not limit the connection time
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Handle to interact with the PTY
+
+
+### resize
+
+```python
+def resize(pid: int,
+ size: PtySize,
+ request_timeout: Optional[float] = None) -> None
+```
+
+Resize PTY.
+
+Call this when the terminal window is resized and the number of columns and rows has changed.
+
+**Arguments**:
+
+- `pid`: Process ID of the PTY
+- `size`: New size of the PTY
+- `request_timeout`: Timeout for the request in **seconds**s
+
+
+
+
+## Commands
+
+```python
+class Commands()
+```
+
+Module for executing commands in the sandbox.
+
+
+### list
+
+```python
+def list(request_timeout: Optional[float] = None) -> List[ProcessInfo]
+```
+
+Lists all running commands and PTY sessions.
+
+**Arguments**:
+
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+List of running commands and PTY sessions
+
+
+### kill
+
+```python
+def kill(pid: int, request_timeout: Optional[float] = None) -> bool
+```
+
+Kills a running command specified by its process ID.
+
+It uses `SIGKILL` signal to kill the command.
+
+**Arguments**:
+
+- `pid`: Process ID of the command. You can get the list of processes using `sandbox.commands.list()`
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the command was killed, `False` if the command was not found
+
+
+### send\_stdin
+
+```python
+def send_stdin(pid: int, data: str, request_timeout: Optional[float] = None)
+```
+
+Send data to command stdin.
+
+:param pid Process ID of the command. You can get the list of processes using `sandbox.commands.list()`.
+:param data: Data to send to the command
+:param request_timeout: Timeout for the request in **seconds**
+
+
+
+### run
+
+```python
+@overload
+def run(cmd: str,
+ background: Union[Literal[False], None] = None,
+ envs: Optional[Dict[str, str]] = None,
+ user: Optional[Username] = None,
+ cwd: Optional[str] = None,
+ on_stdout: Optional[Callable[[str], None]] = None,
+ on_stderr: Optional[Callable[[str], None]] = None,
+ stdin: Optional[bool] = None,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> CommandResult
+```
+
+Start a new command and wait until it finishes executing.
+
+**Arguments**:
+
+- `cmd`: Command to execute
+- `background`: **`False` if the command should be executed in the foreground**, `True` if the command should be executed in the background
+- `envs`: Environment variables used for the command
+- `user`: User to run the command as
+- `cwd`: Working directory to run the command
+- `on_stdout`: Callback for command stdout output
+- `on_stderr`: Callback for command stderr output
+- `stdin`: If `True`, the command will have a stdin stream that you can send data to using `sandbox.commands.send_stdin()`
+- `timeout`: Timeout for the command connection in **seconds**. Using `0` will not limit the command connection time
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`CommandResult` result of the command execution
+
+
+### run
+
+```python
+@overload
+def run(cmd: str,
+ background: Literal[True],
+ envs: Optional[Dict[str, str]] = None,
+ user: Optional[Username] = None,
+ cwd: Optional[str] = None,
+ on_stdout: None = None,
+ on_stderr: None = None,
+ stdin: Optional[bool] = None,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None) -> CommandHandle
+```
+
+Start a new command and return a handle to interact with it.
+
+**Arguments**:
+
+- `cmd`: Command to execute
+- `background`: `False` if the command should be executed in the foreground, **`True` if the command should be executed in the background**
+- `envs`: Environment variables used for the command
+- `user`: User to run the command as
+- `cwd`: Working directory to run the command
+- `stdin`: If `True`, the command will have a stdin stream that you can send data to using `sandbox.commands.send_stdin()`
+- `timeout`: Timeout for the command connection in **seconds**. Using `0` will not limit the command connection time
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`CommandHandle` handle to interact with the running command
+
+
+### connect
+
+```python
+def connect(pid: int,
+ timeout: Optional[float] = 60,
+ request_timeout: Optional[float] = None)
+```
+
+Connects to a running command.
+
+You can use `CommandHandle.wait()` to wait for the command to finish and get execution results.
+
+**Arguments**:
+
+- `pid`: Process ID of the command to connect to. You can get the list of processes using `sandbox.commands.list()`
+- `timeout`: Timeout for the connection in **seconds**. Using `0` will not limit the connection time
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`CommandHandle` handle to interact with the running command
+
+
+
+
+## SandboxApi
+
+```python
+class SandboxApi(SandboxBase)
+```
+
+
+### list
+
+```python
+@staticmethod
+def list(query: Optional[SandboxQuery] = None,
+ limit: Optional[int] = None,
+ next_token: Optional[str] = None,
+ **opts: Unpack[ApiParams]) -> SandboxPaginator
+```
+
+List all running sandboxes.
+
+**Arguments**:
+
+- `query`: Filter the list of sandboxes by metadata or state, e.g. `SandboxListQuery(metadata={"key": "value"})` or `SandboxListQuery(state=[SandboxState.RUNNING])`
+- `limit`: Maximum number of sandboxes to return per page
+- `next_token`: Token for pagination
+
+**Returns**:
+
+List of running sandboxes
+
+
+
+
+## Sandbox
+
+```python
+class Sandbox(SandboxApi)
+```
+
+E2B cloud sandbox is a secure and isolated cloud environment.
+
+The sandbox allows you to:
+- Access Linux OS
+- Create, list, and delete files and directories
+- Run commands
+- Run isolated code
+- Access the internet
+
+Check docs [here](https://e2b.dev/docs).
+
+Use the `Sandbox.create()` to create a new sandbox.
+
+**Example**:
+
+```python
+from e2b import Sandbox
+
+sandbox = Sandbox.create()
+```
+
+
+### files
+
+```python
+@property
+def files() -> Filesystem
+```
+
+Module for interacting with the sandbox filesystem.
+
+
+### commands
+
+```python
+@property
+def commands() -> Commands
+```
+
+Module for running commands in the sandbox.
+
+
+### pty
+
+```python
+@property
+def pty() -> Pty
+```
+
+Module for interacting with the sandbox pseudo-terminal.
+
+
+### \_\_init\_\_
+
+```python
+def __init__(**opts: Unpack[SandboxOpts])
+```
+
+:deprecated: This constructor is deprecated
+
+Use `Sandbox.create()` to create a new sandbox instead.
+
+
+### is\_running
+
+```python
+def is_running(request_timeout: Optional[float] = None) -> bool
+```
+
+Check if the sandbox is running.
+
+**Arguments**:
+
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the sandbox is running, `False` otherwise
+Example
+```python
+sandbox = Sandbox.create()
+sandbox.is_running() # Returns True
+
+sandbox.kill()
+sandbox.is_running() # Returns False
+```
+
+
+### create
+
+```python
+@classmethod
+def create(cls,
+ template: Optional[str] = None,
+ timeout: Optional[int] = None,
+ metadata: Optional[Dict[str, str]] = None,
+ envs: Optional[Dict[str, str]] = None,
+ secure: bool = True,
+ allow_internet_access: bool = True,
+ mcp: Optional[McpServer] = None,
+ network: Optional[SandboxNetworkOpts] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+Create a new sandbox.
+
+By default, the sandbox is created from the default `base` sandbox template.
+
+**Arguments**:
+
+- `template`: Sandbox template name or ID
+- `timeout`: Timeout for the sandbox in **seconds**, default to 300 seconds. The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+- `metadata`: Custom metadata for the sandbox
+- `envs`: Custom environment variables for the sandbox
+- `secure`: Envd is secured with access token and cannot be used without it, defaults to `True`.
+- `allow_internet_access`: Allow sandbox to access the internet, defaults to `True`. If set to `False`, it works the same as setting network `deny_out` to `[0.0.0.0/0]`.
+- `mcp`: MCP server to enable in the sandbox
+- `network`: Sandbox network configuration
+
+**Returns**:
+
+A Sandbox instance for the new sandbox
+Use this method instead of using the constructor to create a new sandbox.
+
+
+### connect
+
+```python
+@overload
+def connect(timeout: Optional[int] = None, **opts: Unpack[ApiParams]) -> Self
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**
+For running sandboxes, the timeout will update only if the new timeout is longer than the existing one.
+
+**Returns**:
+
+A running sandbox instance
+@example
+```python
+sandbox = Sandbox.create()
+sandbox.beta_pause()
+
+same_sandbox = sandbox.connect()
+
+
+### connect
+
+```python
+@overload
+@classmethod
+def connect(cls,
+ sandbox_id: str,
+ timeout: Optional[int] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+- `timeout`: Timeout for the sandbox in **seconds**.
+For running sandboxes, the timeout will update only if the new timeout is longer than the existing one.
+
+**Returns**:
+
+A running sandbox instance
+@example
+```python
+sandbox = Sandbox.create()
+Sandbox.beta_pause(sandbox.sandbox_id)
+
+same_sandbox = Sandbox.connect(sandbox.sandbox_id)
+```
+
+
+### connect
+
+```python
+@class_method_variant("_cls_connect")
+def connect(timeout: Optional[int] = None, **opts: Unpack[ApiParams]) -> Self
+```
+
+Connect to a sandbox. If the sandbox is paused, it will be automatically resumed.
+
+Sandbox must be either running or be paused.
+
+With sandbox ID you can connect to the same sandbox from different places or environments (serverless functions, etc).
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**.
+For running sandboxes, the timeout will update only if the new timeout is longer than the existing one.
+
+**Returns**:
+
+A running sandbox instance
+@example
+```python
+sandbox = Sandbox.create()
+sandbox.beta_pause()
+
+same_sandbox = sandbox.connect()
+```
+
+
+### kill
+
+```python
+@overload
+def kill(**opts: Unpack[ApiParams]) -> bool
+```
+
+Kill the sandbox.
+
+**Returns**:
+
+`True` if the sandbox was killed, `False` if the sandbox was not found
+
+
+### kill
+
+```python
+@overload
+@staticmethod
+def kill(sandbox_id: str, **opts: Unpack[ApiParams]) -> bool
+```
+
+Kill the sandbox specified by sandbox ID.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+
+**Returns**:
+
+`True` if the sandbox was killed, `False` if the sandbox was not found
+
+
+### kill
+
+```python
+@class_method_variant("_cls_kill")
+def kill(**opts: Unpack[ApiParams]) -> bool
+```
+
+Kill the sandbox specified by sandbox ID.
+
+**Returns**:
+
+`True` if the sandbox was killed, `False` if the sandbox was not found
+
+
+### set\_timeout
+
+```python
+@overload
+def set_timeout(timeout: int, **opts: Unpack[ApiParams]) -> None
+```
+
+Set the timeout of the sandbox.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to `.set_timeout`.
+
+The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**
+
+
+### set\_timeout
+
+```python
+@overload
+@staticmethod
+def set_timeout(sandbox_id: str, timeout: int,
+ **opts: Unpack[ApiParams]) -> None
+```
+
+Set the timeout of the sandbox specified by sandbox ID.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to `.set_timeout`.
+
+The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+- `timeout`: Timeout for the sandbox in **seconds**
+
+
+### set\_timeout
+
+```python
+@class_method_variant("_cls_set_timeout")
+def set_timeout(timeout: int, **opts: Unpack[ApiParams]) -> None
+```
+
+Set the timeout of the sandbox.
+
+This method can extend or reduce the sandbox timeout set when creating the sandbox or from the last call to `.set_timeout`.
+
+The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+
+**Arguments**:
+
+- `timeout`: Timeout for the sandbox in **seconds**
+
+
+### get\_info
+
+```python
+@overload
+def get_info(**opts: Unpack[ApiParams]) -> SandboxInfo
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+**Returns**:
+
+Sandbox info
+
+
+### get\_info
+
+```python
+@overload
+@staticmethod
+def get_info(sandbox_id: str, **opts: Unpack[ApiParams]) -> SandboxInfo
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+
+**Returns**:
+
+Sandbox info
+
+
+### get\_info
+
+```python
+@class_method_variant("_cls_get_info")
+def get_info(**opts: Unpack[ApiParams]) -> SandboxInfo
+```
+
+Get sandbox information like sandbox ID, template, metadata, started at/end at date.
+
+**Returns**:
+
+Sandbox info
+
+
+### get\_metrics
+
+```python
+@overload
+def get_metrics(start: Optional[datetime.datetime] = None,
+ end: Optional[datetime.datetime] = None,
+ **opts: Unpack[ApiParams]) -> List[SandboxMetrics]
+```
+
+Get the metrics of the current sandbox.
+
+**Arguments**:
+
+- `start`: Start time for the metrics, defaults to the start of the sandbox
+- `end`: End time for the metrics, defaults to the current time
+
+**Returns**:
+
+List of sandbox metrics containing CPU, memory and disk usage information
+
+
+### get\_metrics
+
+```python
+@overload
+@staticmethod
+def get_metrics(sandbox_id: str,
+ start: Optional[datetime.datetime] = None,
+ end: Optional[datetime.datetime] = None,
+ **opts: Unpack[ApiParams]) -> List[SandboxMetrics]
+```
+
+Get the metrics of the sandbox specified by sandbox ID.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+- `start`: Start time for the metrics, defaults to the start of the sandbox
+- `end`: End time for the metrics, defaults to the current time
+
+**Returns**:
+
+List of sandbox metrics containing CPU, memory and disk usage information
+
+
+### get\_metrics
+
+```python
+@class_method_variant("_cls_get_metrics")
+def get_metrics(start: Optional[datetime.datetime] = None,
+ end: Optional[datetime.datetime] = None,
+ **opts: Unpack[ApiParams]) -> List[SandboxMetrics]
+```
+
+Get the metrics of the sandbox specified by sandbox ID.
+
+**Arguments**:
+
+- `start`: Start time for the metrics, defaults to the start of the sandbox
+- `end`: End time for the metrics, defaults to the current time
+
+**Returns**:
+
+List of sandbox metrics containing CPU, memory and disk usage information
+
+
+### beta\_create
+
+```python
+@classmethod
+def beta_create(cls,
+ template: Optional[str] = None,
+ timeout: Optional[int] = None,
+ auto_pause: bool = False,
+ metadata: Optional[Dict[str, str]] = None,
+ envs: Optional[Dict[str, str]] = None,
+ secure: bool = True,
+ allow_internet_access: bool = True,
+ mcp: Optional[McpServer] = None,
+ **opts: Unpack[ApiParams]) -> Self
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Create a new sandbox.
+
+By default, the sandbox is created from the default `base` sandbox template.
+
+**Arguments**:
+
+- `template`: Sandbox template name or ID
+- `timeout`: Timeout for the sandbox in **seconds**, default to 300 seconds. The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
+- `auto_pause`: Automatically pause the sandbox after the timeout expires. Defaults to `False`.
+- `metadata`: Custom metadata for the sandbox
+- `envs`: Custom environment variables for the sandbox
+- `secure`: Envd is secured with access token and cannot be used without it, defaults to `True`.
+- `allow_internet_access`: Allow sandbox to access the internet, defaults to `True`.
+- `mcp`: MCP server to enable in the sandbox
+
+**Returns**:
+
+A Sandbox instance for the new sandbox
+Use this method instead of using the constructor to create a new sandbox.
+
+
+### beta\_pause
+
+```python
+@overload
+def beta_pause(**opts: Unpack[ApiParams]) -> None
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Pause the sandbox.
+
+
+### beta\_pause
+
+```python
+@overload
+@classmethod
+def beta_pause(cls, sandbox_id: str, **opts: Unpack[ApiParams]) -> None
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Pause the sandbox specified by sandbox ID.
+
+**Arguments**:
+
+- `sandbox_id`: Sandbox ID
+
+
+### beta\_pause
+
+```python
+@class_method_variant("_cls_pause")
+def beta_pause(**opts: Unpack[ApiParams]) -> None
+```
+
+[BETA] This feature is in beta and may change in the future.
+
+Pause the sandbox.
+
+**Returns**:
+
+Sandbox ID that can be used to resume the sandbox
+
+
+### get\_mcp\_token
+
+```python
+def get_mcp_token() -> Optional[str]
+```
+
+Get the MCP token for the sandbox.
+
+**Returns**:
+
+MCP token for the sandbox, or None if MCP is not enabled.
+
+
+
+
+## Filesystem
+
+```python
+class Filesystem()
+```
+
+Module for interacting with the filesystem in the sandbox.
+
+
+### read
+
+```python
+@overload
+def read(path: str,
+ format: Literal["text"] = "text",
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> str
+```
+
+Read file content as a `str`.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `user`: Run the operation as this user
+- `format`: Format of the file content—`text` by default
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+File content as a `str`
+
+
+### read
+
+```python
+@overload
+def read(path: str,
+ format: Literal["bytes"],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> bytearray
+```
+
+Read file content as a `bytearray`.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `user`: Run the operation as this user
+- `format`: Format of the file content—`bytes`
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+File content as a `bytearray`
+
+
+### read
+
+```python
+@overload
+def read(path: str,
+ format: Literal["stream"],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> Iterator[bytes]
+```
+
+Read file content as a `Iterator[bytes]`.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `user`: Run the operation as this user
+- `format`: Format of the file content—`stream`
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+File content as an `Iterator[bytes]`
+
+
+### write
+
+```python
+def write(path: str,
+ data: Union[str, bytes, IO],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> WriteInfo
+```
+
+Write content to a file on the path.
+
+Writing to a file that doesn't exist creates the file.
+Writing to a file that already exists overwrites the file.
+Writing to a file at path that doesn't exist creates the necessary directories.
+
+**Arguments**:
+
+- `path`: Path to the file
+- `data`: Data to write to the file, can be a `str`, `bytes`, or `IO`.
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Information about the written file
+
+
+### write\_files
+
+```python
+def write_files(files: List[WriteEntry],
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> List[WriteInfo]
+```
+
+Writes a list of files to the filesystem.
+
+When writing to a file that doesn't exist, the file will get created.
+When writing to a file that already exists, the file will get overwritten.
+When writing to a file that's in a directory that doesn't exist, you'll get an error.
+
+**Arguments**:
+
+- `files`: list of files to write as `WriteEntry` objects, each containing `path` and `data`
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request
+
+**Returns**:
+
+Information about the written files
+
+
+### list
+
+```python
+def list(path: str,
+ depth: Optional[int] = 1,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> List[EntryInfo]
+```
+
+List entries in a directory.
+
+**Arguments**:
+
+- `path`: Path to the directory
+- `depth`: Depth of the directory to list
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+List of entries in the directory
+
+
+### exists
+
+```python
+def exists(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> bool
+```
+
+Check if a file or a directory exists.
+
+**Arguments**:
+
+- `path`: Path to a file or a directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the file or directory exists, `False` otherwise
+
+
+### get\_info
+
+```python
+def get_info(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> EntryInfo
+```
+
+Get information about a file or directory.
+
+**Arguments**:
+
+- `path`: Path to a file or a directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Information about the file or directory like name, type, and path
+
+
+### remove
+
+```python
+def remove(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> None
+```
+
+Remove a file or a directory.
+
+**Arguments**:
+
+- `path`: Path to a file or a directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+
+### rename
+
+```python
+def rename(old_path: str,
+ new_path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> EntryInfo
+```
+
+Rename a file or directory.
+
+**Arguments**:
+
+- `old_path`: Path to the file or directory to rename
+- `new_path`: New path to the file or directory
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+Information about the renamed file or directory
+
+
+### make\_dir
+
+```python
+def make_dir(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None) -> bool
+```
+
+Create a new directory and all directories along the way if needed on the specified path.
+
+**Arguments**:
+
+- `path`: Path to a new directory. For example '/dirA/dirB' when creating 'dirB'.
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+
+**Returns**:
+
+`True` if the directory was created, `False` if the directory already exists
+
+
+### watch\_dir
+
+```python
+def watch_dir(path: str,
+ user: Optional[Username] = None,
+ request_timeout: Optional[float] = None,
+ recursive: bool = False) -> WatchHandle
+```
+
+Watch directory for filesystem events.
+
+**Arguments**:
+
+- `path`: Path to a directory to watch
+- `user`: Run the operation as this user
+- `request_timeout`: Timeout for the request in **seconds**
+- `recursive`: Watch directory recursively
+
+**Returns**:
+
+`WatchHandle` object for stopping watching directory
+
+
+
+
+## WatchHandle
+
+```python
+class WatchHandle()
+```
+
+Handle for watching filesystem events.
+It is used to get the latest events that have occurred in the watched directory.
+
+Use `.stop()` to stop watching the directory.
+
+
+### stop
+
+```python
+def stop()
+```
+
+Stop watching the directory.
+After you stop the watcher you won't be able to get the events anymore.
+
+
+### get\_new\_events
+
+```python
+def get_new_events() -> List[FilesystemEvent]
+```
+
+Get the latest events that have occurred in the watched directory since the last call, or from the beginning of the watching, up until now.
+
+**Returns**:
+
+List of filesystem events
+
+
+
+
+## SandboxPaginator
+
+```python
+class SandboxPaginator(SandboxPaginatorBase)
+```
+
+Paginator for listing sandboxes.
+
+**Example**:
+
+```python
+paginator = Sandbox.list()
+
+while paginator.has_next:
+ sandboxes = paginator.next_items()
+ print(sandboxes)
+```
+
+
+### next\_items
+
+```python
+def next_items() -> List[SandboxInfo]
+```
+
+Returns the next page of sandboxes.
+
+Call this method only if `has_next` is `True`, otherwise it will raise an exception.
+
+**Returns**:
+
+List of sandboxes
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template/page.mdx
new file mode 100644
index 000000000..8468e0748
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template/page.mdx
@@ -0,0 +1,1730 @@
+
+
+
+## ReadyCmd
+
+```python
+class ReadyCmd()
+```
+
+Wrapper class for ready check commands.
+
+
+### wait\_for\_port
+
+```python
+def wait_for_port(port: int)
+```
+
+Wait for a port to be listening.
+
+Uses `ss` command to check if a port is open and listening.
+
+**Arguments**:
+
+- `port`: Port number to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the port
+Example
+```python
+from e2b import Template, wait_for_port
+
+template = (
+ Template()
+ .from_python_image()
+ .set_start_cmd('python -m http.server 8000', wait_for_port(8000))
+)
+```
+
+
+### wait\_for\_url
+
+```python
+def wait_for_url(url: str, status_code: int = 200)
+```
+
+Wait for a URL to return a specific HTTP status code.
+
+Uses `curl` to make HTTP requests and check the response status.
+
+**Arguments**:
+
+- `url`: URL to check (e.g., 'http://localhost:3000/health')
+- `status_code`: Expected HTTP status code (default: 200)
+
+**Returns**:
+
+ReadyCmd that checks the URL
+Example
+```python
+from e2b import Template, wait_for_url
+
+template = (
+ Template()
+ .from_node_image()
+ .set_start_cmd('npm start', wait_for_url('http://localhost:3000/health'))
+)
+```
+
+
+### wait\_for\_process
+
+```python
+def wait_for_process(process_name: str)
+```
+
+Wait for a process with a specific name to be running.
+
+Uses `pgrep` to check if a process exists.
+
+**Arguments**:
+
+- `process_name`: Name of the process to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the process
+Example
+```python
+from e2b import Template, wait_for_process
+
+template = (
+ Template()
+ .from_base_image()
+ .set_start_cmd('./my-daemon', wait_for_process('my-daemon'))
+)
+```
+
+
+### wait\_for\_file
+
+```python
+def wait_for_file(filename: str)
+```
+
+Wait for a file to exist.
+
+Uses shell test command to check file existence.
+
+**Arguments**:
+
+- `filename`: Path to the file to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the file
+Example
+```python
+from e2b import Template, wait_for_file
+
+template = (
+ Template()
+ .from_base_image()
+ .set_start_cmd('./init.sh', wait_for_file('/tmp/ready'))
+)
+```
+
+
+### wait\_for\_timeout
+
+```python
+def wait_for_timeout(timeout: int)
+```
+
+Wait for a specified timeout before considering the sandbox ready.
+
+Uses `sleep` command to wait for a fixed duration.
+
+**Arguments**:
+
+- `timeout`: Time to wait in **milliseconds** (minimum: 1000ms / 1 second)
+
+**Returns**:
+
+ReadyCmd that waits for the specified duration
+Example
+```python
+from e2b import Template, wait_for_timeout
+
+template = (
+ Template()
+ .from_node_image()
+ .set_start_cmd('npm start', wait_for_timeout(5000)) # Wait 5 seconds
+)
+```
+
+
+
+
+## DockerfFileFinalParserInterface
+
+```python
+class DockerfFileFinalParserInterface(Protocol)
+```
+
+Protocol defining the final interface for Dockerfile parsing callbacks.
+
+
+## DockerfileParserInterface
+
+```python
+class DockerfileParserInterface(Protocol)
+```
+
+Protocol defining the interface for Dockerfile parsing callbacks.
+
+
+### run\_cmd
+
+```python
+def run_cmd(command: Union[str, List[str]],
+ user: Optional[str] = None) -> "DockerfileParserInterface"
+```
+
+Handle RUN instruction.
+
+
+### copy
+
+```python
+def copy(src: Union[str, List[CopyItem]],
+ dest: Optional[str] = None,
+ force_upload: Optional[Literal[True]] = None,
+ resolve_symlinks: Optional[bool] = None,
+ user: Optional[str] = None,
+ mode: Optional[int] = None) -> "DockerfileParserInterface"
+```
+
+Handle COPY instruction.
+
+
+### set\_workdir
+
+```python
+def set_workdir(workdir: str) -> "DockerfileParserInterface"
+```
+
+Handle WORKDIR instruction.
+
+
+### set\_user
+
+```python
+def set_user(user: str) -> "DockerfileParserInterface"
+```
+
+Handle USER instruction.
+
+
+### set\_envs
+
+```python
+def set_envs(envs: Dict[str, str]) -> "DockerfileParserInterface"
+```
+
+Handle ENV instruction.
+
+
+### set\_start\_cmd
+
+```python
+def set_start_cmd(start_cmd: str,
+ ready_cmd: str) -> "DockerfFileFinalParserInterface"
+```
+
+Handle CMD/ENTRYPOINT instruction.
+
+
+### parse\_dockerfile
+
+```python
+def parse_dockerfile(dockerfile_content_or_path: str,
+ template_builder: DockerfileParserInterface) -> str
+```
+
+Parse a Dockerfile and convert it to Template SDK format.
+
+**Arguments**:
+
+- `dockerfile_content_or_path`: Either the Dockerfile content as a string, or a path to a Dockerfile file
+- `template_builder`: Interface providing template builder methods
+
+**Raises**:
+
+- `ValueError`: If the Dockerfile is invalid or unsupported
+
+**Returns**:
+
+The base image from the Dockerfile
+
+
+
+Special step name for the finalization phase of template building.
+This is the last step that runs after all user-defined instructions.
+
+
+### FINALIZE\_STEP\_NAME
+
+Special step name for the base image phase of template building.
+This is the first step that sets up the base image.
+
+
+### BASE\_STEP\_NAME
+
+Stack trace depth for capturing caller information.
+
+Depth levels:
+1. TemplateClass
+2. Caller method (e.g., copy(), from_image(), etc.)
+
+This depth is used to determine the original caller's location
+for stack traces.
+
+
+### STACK\_TRACE\_DEPTH
+
+Default setting for whether to resolve symbolic links when copying files.
+When False, symlinks are copied as symlinks rather than following them.
+
+
+
+
+## TemplateBuilder
+
+```python
+class TemplateBuilder()
+```
+
+Builder class for adding instructions to an E2B template.
+
+All methods return self to allow method chaining.
+
+
+### copy
+
+```python
+def copy(src: Union[Union[str, Path], List[Union[str, Path]]],
+ dest: Union[str, Path],
+ force_upload: Optional[Literal[True]] = None,
+ user: Optional[str] = None,
+ mode: Optional[int] = None,
+ resolve_symlinks: Optional[bool] = None) -> "TemplateBuilder"
+```
+
+Copy files or directories from the local filesystem into the template.
+
+**Arguments**:
+
+- `src`: Source file(s) or directory path(s) to copy
+- `dest`: Destination path in the template
+- `force_upload`: Force upload even if files are cached
+- `user`: User and optionally group (user:group) to own the files
+- `mode`: File permissions in octal format (e.g., 0o755)
+- `resolve_symlinks`: Whether to resolve symlinks
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.copy('requirements.txt', '/home/user/')
+template.copy(['app.py', 'config.py'], '/app/', mode=0o755)
+```
+
+
+### copy\_items
+
+```python
+def copy_items(items: List[CopyItem]) -> "TemplateBuilder"
+```
+
+Copy multiple files or directories using a list of copy items.
+
+**Arguments**:
+
+- `items`: List of CopyItem dictionaries with src, dest, and optional parameters
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.copy_items([
+ {'src': 'app.py', 'dest': '/app/'},
+ {'src': 'config.py', 'dest': '/app/', 'mode': 0o644}
+])
+```
+
+
+### remove
+
+```python
+def remove(path: Union[Union[str, Path], List[Union[str, Path]]],
+ force: bool = False,
+ recursive: bool = False,
+ user: Optional[str] = None) -> "TemplateBuilder"
+```
+
+Remove files or directories in the template.
+
+**Arguments**:
+
+- `path`: File(s) or directory path(s) to remove
+- `force`: Force removal without prompting
+- `recursive`: Remove directories recursively
+- `user`: User to run the command as
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.remove('/tmp/cache', recursive=True, force=True)
+template.remove('/tmp/cache', recursive=True, force=True, user='root')
+```
+
+
+### rename
+
+```python
+def rename(src: Union[str, Path],
+ dest: Union[str, Path],
+ force: bool = False,
+ user: Optional[str] = None) -> "TemplateBuilder"
+```
+
+Rename or move a file or directory in the template.
+
+**Arguments**:
+
+- `src`: Source path
+- `dest`: Destination path
+- `force`: Force rename without prompting
+- `user`: User to run the command as
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.rename('/tmp/old.txt', '/tmp/new.txt')
+template.rename('/tmp/old.txt', '/tmp/new.txt', user='root')
+```
+
+
+### make\_dir
+
+```python
+def make_dir(path: Union[Union[str, Path], List[Union[str, Path]]],
+ mode: Optional[int] = None,
+ user: Optional[str] = None) -> "TemplateBuilder"
+```
+
+Create directory(ies) in the template.
+
+**Arguments**:
+
+- `path`: Directory path(s) to create
+- `mode`: Directory permissions in octal format (e.g., 0o755)
+- `user`: User to run the command as
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.make_dir('/app/data', mode=0o755)
+template.make_dir(['/app/logs', '/app/cache'])
+template.make_dir('/app/data', mode=0o755, user='root')
+```
+
+
+### make\_symlink
+
+```python
+def make_symlink(src: Union[str, Path],
+ dest: Union[str, Path],
+ user: Optional[str] = None,
+ force: bool = False) -> "TemplateBuilder"
+```
+
+Create a symbolic link in the template.
+
+**Arguments**:
+
+- `src`: Source path (target of the symlink)
+- `dest`: Destination path (location of the symlink)
+- `user`: User to run the command as
+- `force`: Force symlink without prompting
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.make_symlink('/usr/bin/python3', '/usr/bin/python')
+template.make_symlink('/usr/bin/python3', '/usr/bin/python', user='root')
+template.make_symlink('/usr/bin/python3', '/usr/bin/python', force=True)
+```
+
+
+### run\_cmd
+
+```python
+def run_cmd(command: Union[str, List[str]],
+ user: Optional[str] = None) -> "TemplateBuilder"
+```
+
+Run a shell command during template build.
+
+**Arguments**:
+
+- `command`: Command string or list of commands to run (joined with &&)
+- `user`: User to run the command as
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.run_cmd('apt-get update')
+template.run_cmd(['pip install numpy', 'pip install pandas'])
+template.run_cmd('apt-get install vim', user='root')
+```
+
+
+### set\_workdir
+
+```python
+def set_workdir(workdir: Union[str, Path]) -> "TemplateBuilder"
+```
+
+Set the working directory for subsequent commands in the template.
+
+**Arguments**:
+
+- `workdir`: Path to set as the working directory
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.set_workdir('/app')
+```
+
+
+### set\_user
+
+```python
+def set_user(user: str) -> "TemplateBuilder"
+```
+
+Set the user for subsequent commands in the template.
+
+**Arguments**:
+
+- `user`: Username to set
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.set_user('root')
+```
+
+
+### pip\_install
+
+```python
+def pip_install(packages: Optional[Union[str, List[str]]] = None,
+ g: bool = True) -> "TemplateBuilder"
+```
+
+Install Python packages using pip.
+
+**Arguments**:
+
+- `packages`: Package name(s) to install. If None, runs 'pip install .' in the current directory
+- `g`: Install packages globally (default: True). If False, installs for user only
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.pip_install('numpy')
+template.pip_install(['pandas', 'scikit-learn'])
+template.pip_install('numpy', g=False) # Install for user only
+template.pip_install() # Installs from current directory
+```
+
+
+### npm\_install
+
+```python
+def npm_install(packages: Optional[Union[str, List[str]]] = None,
+ g: Optional[bool] = False,
+ dev: Optional[bool] = False) -> "TemplateBuilder"
+```
+
+Install Node.js packages using npm.
+
+**Arguments**:
+
+- `packages`: Package name(s) to install. If None, installs from package.json
+- `g`: Install packages globally
+- `dev`: Install packages as dev dependencies
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.npm_install('express')
+template.npm_install(['lodash', 'axios'])
+template.npm_install('typescript', g=True)
+template.npm_install() # Installs from package.json
+```
+
+
+### bun\_install
+
+```python
+def bun_install(packages: Optional[Union[str, List[str]]] = None,
+ g: Optional[bool] = False,
+ dev: Optional[bool] = False) -> "TemplateBuilder"
+```
+
+Install Bun packages using bun.
+
+**Arguments**:
+
+- `packages`: Package name(s) to install. If None, installs from package.json
+- `g`: Install packages globally
+- `dev`: Install packages as dev dependencies
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.bun_install('express')
+template.bun_install(['lodash', 'axios'])
+template.bun_install('tsx', g=True)
+template.bun_install('typescript', dev=True)
+template.bun_install() // Installs from package.json
+```
+
+
+### apt\_install
+
+```python
+def apt_install(packages: Union[str, List[str]],
+ no_install_recommends: bool = False) -> "TemplateBuilder"
+```
+
+Install system packages using apt-get.
+
+**Arguments**:
+
+- `packages`: Package name(s) to install
+- `no_install_recommends`: Whether to install recommended packages
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.apt_install('vim')
+template.apt_install(['git', 'curl', 'wget'])
+```
+
+
+### add\_mcp\_server
+
+```python
+def add_mcp_server(servers: Union[str, List[str]]) -> "TemplateBuilder"
+```
+
+Install MCP servers using mcp-gateway.
+
+Note: Requires a base image with mcp-gateway pre-installed (e.g., mcp-gateway).
+
+**Arguments**:
+
+- `servers`: MCP server name(s)
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.add_mcp_server('exa')
+template.add_mcp_server(['brave', 'firecrawl', 'duckduckgo'])
+```
+
+
+### git\_clone
+
+```python
+def git_clone(url: str,
+ path: Optional[Union[str, Path]] = None,
+ branch: Optional[str] = None,
+ depth: Optional[int] = None,
+ user: Optional[str] = None) -> "TemplateBuilder"
+```
+
+Clone a git repository into the template.
+
+**Arguments**:
+
+- `url`: Git repository URL
+- `path`: Destination path for the clone
+- `branch`: Branch to clone
+- `depth`: Clone depth for shallow clones
+- `user`: User to run the command as
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.git_clone('https://github.com/user/repo.git', '/app/repo')
+template.git_clone('https://github.com/user/repo.git', branch='main', depth=1)
+template.git_clone('https://github.com/user/repo.git', '/app/repo', user='root')
+```
+
+
+### beta\_dev\_container\_prebuild
+
+```python
+def beta_dev_container_prebuild(
+ devcontainer_directory: Union[str, Path]) -> "TemplateBuilder"
+```
+
+Prebuild a devcontainer from the specified directory during the build process.
+
+**Arguments**:
+
+- `devcontainer_directory`: Path to the devcontainer directory
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.git_clone('https://myrepo.com/project.git', '/my-devcontainer')
+template.beta_dev_container_prebuild('/my-devcontainer')
+```
+
+
+### beta\_set\_dev\_container\_start
+
+```python
+def beta_set_dev_container_start(
+ devcontainer_directory: Union[str, Path]) -> "TemplateFinal"
+```
+
+Start a devcontainer from the specified directory and set it as the start command.
+
+This method returns `TemplateFinal`, which means it must be the last method in the chain.
+
+**Arguments**:
+
+- `devcontainer_directory`: Path to the devcontainer directory
+
+**Returns**:
+
+`TemplateFinal` class
+Example
+```python
+template.git_clone('https://myrepo.com/project.git', '/my-devcontainer')
+template.beta_set_devcontainer_start('/my-devcontainer')
+
+template.git_clone('https://myrepo.com/project.git', '/my-devcontainer')
+template.beta_dev_container_prebuild('/my-devcontainer')
+template.beta_set_dev_container_start('/my-devcontainer')
+```
+
+
+### set\_envs
+
+```python
+def set_envs(envs: Dict[str, str]) -> "TemplateBuilder"
+```
+
+Set environment variables.
+
+Note: Environment variables defined here are available only during template build.
+
+**Arguments**:
+
+- `envs`: Dictionary of environment variable names and values
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.set_envs({'NODE_ENV': 'production', 'PORT': '8080'})
+```
+
+
+### skip\_cache
+
+```python
+def skip_cache() -> "TemplateBuilder"
+```
+
+Skip cache for all subsequent build instructions from this point.
+
+Call this before any instruction to force it and all following layers
+to be rebuilt, ignoring any cached layers.
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+template.skip_cache().run_cmd('apt-get update')
+```
+
+
+### set\_start\_cmd
+
+```python
+def set_start_cmd(start_cmd: str,
+ ready_cmd: Union[str, ReadyCmd]) -> "TemplateFinal"
+```
+
+Set the command to start when the sandbox launches and the ready check command.
+
+**Arguments**:
+
+- `start_cmd`: Command to run when the sandbox starts
+- `ready_cmd`: Command or ReadyCmd to check if the sandbox is ready
+
+**Returns**:
+
+`TemplateFinal` class
+Example
+```python
+template.set_start_cmd(
+ 'python app.py',
+ 'curl http://localhost:8000/health'
+)
+
+from e2b import wait_for_port, wait_for_url
+
+template.set_start_cmd(
+ 'python -m http.server 8000',
+ wait_for_port(8000)
+)
+
+template.set_start_cmd(
+ 'npm start',
+ wait_for_url('http://localhost:3000/health', 200)
+)
+```
+
+
+### set\_ready\_cmd
+
+```python
+def set_ready_cmd(ready_cmd: Union[str, ReadyCmd]) -> "TemplateFinal"
+```
+
+Set the command to check if the sandbox is ready.
+
+**Arguments**:
+
+- `ready_cmd`: Command or ReadyCmd to check if the sandbox is ready
+
+**Returns**:
+
+`TemplateFinal` class
+Example
+```python
+template.set_ready_cmd('curl http://localhost:8000/health')
+
+from e2b import wait_for_port, wait_for_file, wait_for_process
+
+template.set_ready_cmd(wait_for_port(3000))
+
+template.set_ready_cmd(wait_for_file('/tmp/ready'))
+
+template.set_ready_cmd(wait_for_process('nginx'))
+```
+
+
+## TemplateFinal
+
+```python
+class TemplateFinal()
+```
+
+Final template state after start/ready commands are set.
+
+
+## TemplateBase
+
+```python
+class TemplateBase()
+```
+
+Base class for building E2B sandbox templates.
+
+
+### \_\_init\_\_
+
+```python
+def __init__(file_context_path: Optional[Union[str, Path]] = None,
+ file_ignore_patterns: Optional[List[str]] = None)
+```
+
+Create a new template builder instance.
+
+**Arguments**:
+
+- `file_context_path`: Base path for resolving relative file paths in copy operations
+- `file_ignore_patterns`: List of glob patterns to ignore when copying files
+
+
+### skip\_cache
+
+```python
+def skip_cache() -> "TemplateBase"
+```
+
+Skip cache for all subsequent build instructions from this point.
+
+**Returns**:
+
+`TemplateBase` class
+Example
+```python
+template.skip_cache().from_python_image('3.11')
+```
+
+
+### from\_debian\_image
+
+```python
+def from_debian_image(variant: str = "stable") -> TemplateBuilder
+```
+
+Start template from a Debian base image.
+
+**Arguments**:
+
+- `variant`: Debian image variant
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_debian_image('bookworm')
+```
+
+
+### from\_ubuntu\_image
+
+```python
+def from_ubuntu_image(variant: str = "latest") -> TemplateBuilder
+```
+
+Start template from an Ubuntu base image.
+
+**Arguments**:
+
+- `variant`: Ubuntu image variant (default: 'latest')
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_ubuntu_image('24.04')
+```
+
+
+### from\_python\_image
+
+```python
+def from_python_image(version: str = "3") -> TemplateBuilder
+```
+
+Start template from a Python base image.
+
+**Arguments**:
+
+- `version`: Python version (default: '3')
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_python_image('3')
+```
+
+
+### from\_node\_image
+
+```python
+def from_node_image(variant: str = "lts") -> TemplateBuilder
+```
+
+Start template from a Node.js base image.
+
+**Arguments**:
+
+- `variant`: Node.js image variant (default: 'lts')
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_node_image('24')
+```
+
+
+### from\_bun\_image
+
+```python
+def from_bun_image(variant: str = "latest") -> TemplateBuilder
+```
+
+Start template from a Bun base image.
+
+**Arguments**:
+
+- `variant`: Bun image variant (default: 'latest')
+
+**Returns**:
+
+`TemplateBuilder` class
+
+
+### from\_base\_image
+
+```python
+def from_base_image() -> TemplateBuilder
+```
+
+Start template from the E2B base image (e2bdev/base:latest).
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_base_image()
+```
+
+
+### from\_image
+
+```python
+def from_image(image: str,
+ username: Optional[str] = None,
+ password: Optional[str] = None) -> TemplateBuilder
+```
+
+Start template from a Docker image.
+
+**Arguments**:
+
+- `image`: Docker image name (e.g., 'ubuntu:24.04')
+- `username`: Username for private registry authentication
+- `password`: Password for private registry authentication
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_image('python:3')
+
+Template().from_image('myregistry.com/myimage:latest', username='user', password='pass')
+```
+
+
+### from\_template
+
+```python
+def from_template(template: str) -> TemplateBuilder
+```
+
+Start template from an existing E2B template.
+
+**Arguments**:
+
+- `template`: E2B template ID or alias
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_template('my-base-template')
+```
+
+
+### from\_dockerfile
+
+```python
+def from_dockerfile(dockerfile_content_or_path: str) -> TemplateBuilder
+```
+
+Parse a Dockerfile and convert it to Template SDK format.
+
+**Arguments**:
+
+- `dockerfile_content_or_path`: Either the Dockerfile content as a string, or a path to a Dockerfile file
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_dockerfile('Dockerfile')
+Template().from_dockerfile('FROM python:3\nRUN pip install numpy')
+```
+
+
+### from\_aws\_registry
+
+```python
+def from_aws_registry(image: str, access_key_id: str, secret_access_key: str,
+ region: str) -> TemplateBuilder
+```
+
+Start template from an AWS ECR registry image.
+
+**Arguments**:
+
+- `image`: Docker image name from AWS ECR
+- `access_key_id`: AWS access key ID
+- `secret_access_key`: AWS secret access key
+- `region`: AWS region
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_aws_registry(
+ '123456789.dkr.ecr.us-west-2.amazonaws.com/myimage:latest',
+ access_key_id='AKIA...',
+ secret_access_key='...',
+ region='us-west-2'
+)
+```
+
+
+### from\_gcp\_registry
+
+```python
+def from_gcp_registry(
+ image: str, service_account_json: Union[str, dict]) -> TemplateBuilder
+```
+
+Start template from a GCP Artifact Registry or Container Registry image.
+
+**Arguments**:
+
+- `image`: Docker image name from GCP registry
+- `service_account_json`: Service account JSON string, dict, or path to JSON file
+
+**Returns**:
+
+`TemplateBuilder` class
+Example
+```python
+Template().from_gcp_registry(
+ 'gcr.io/myproject/myimage:latest',
+ service_account_json='path/to/service-account.json'
+)
+```
+
+
+### to\_json
+
+```python
+@staticmethod
+def to_json(template: "TemplateClass") -> str
+```
+
+Convert a template to JSON representation.
+
+**Arguments**:
+
+- `template`: The template to convert (TemplateBuilder or TemplateFinal instance)
+
+**Returns**:
+
+JSON string representation of the template
+Example
+```python
+template = Template().from_python_image('3').copy('app.py', '/app/')
+json_str = TemplateBase.to_json(template)
+```
+
+
+### to\_dockerfile
+
+```python
+@staticmethod
+def to_dockerfile(template: "TemplateClass") -> str
+```
+
+Convert a template to Dockerfile format.
+
+Note: Templates based on other E2B templates cannot be converted to Dockerfile.
+
+**Arguments**:
+
+- `template`: The template to convert (TemplateBuilder or TemplateFinal instance)
+
+**Raises**:
+
+- `ValueError`: If the template is based on another E2B template or has no base image
+Example
+```python
+template = Template().from_python_image('3').copy('app.py', '/app/')
+dockerfile = TemplateBase.to_dockerfile(template)
+```
+
+**Returns**:
+
+Dockerfile string representation
+
+
+
+
+## TemplateBuildStatus
+
+```python
+class TemplateBuildStatus(str, Enum)
+```
+
+Status of a template build.
+
+
+## BuildStatusReason
+
+```python
+@dataclass
+class BuildStatusReason()
+```
+
+Reason for the current build status (typically for errors).
+
+
+### message
+
+Message with the status reason.
+
+
+### step
+
+Step that failed.
+
+
+### log\_entries
+
+Log entries related to the status reason.
+
+
+## TemplateBuildStatusResponse
+
+```python
+@dataclass
+class TemplateBuildStatusResponse()
+```
+
+Response from getting build status.
+
+
+### build\_id
+
+Build identifier.
+
+
+### template\_id
+
+Template identifier.
+
+
+### status
+
+Current status of the build.
+
+
+### log\_entries
+
+Build log entries.
+
+
+### logs
+
+Build logs (raw strings). Deprecated: use log_entries instead.
+
+
+### reason
+
+Reason for the current status (typically for errors).
+
+
+## TemplateTagInfo
+
+```python
+@dataclass
+class TemplateTagInfo()
+```
+
+Information about assigned template tags.
+
+
+### build\_id
+
+Build identifier associated with this tag.
+
+
+### tags
+
+Assigned tags of the template.
+
+
+## InstructionType
+
+```python
+class InstructionType(str, Enum)
+```
+
+Types of instructions that can be used in a template.
+
+
+## CopyItem
+
+```python
+class CopyItem(TypedDict)
+```
+
+Configuration for a single file/directory copy operation.
+
+
+## Instruction
+
+```python
+class Instruction(TypedDict)
+```
+
+Represents a single instruction in the template build process.
+
+
+## GenericDockerRegistry
+
+```python
+class GenericDockerRegistry(TypedDict)
+```
+
+Configuration for a generic Docker registry with basic authentication.
+
+
+## AWSRegistry
+
+```python
+class AWSRegistry(TypedDict)
+```
+
+Configuration for AWS Elastic Container Registry (ECR).
+
+
+## GCPRegistry
+
+```python
+class GCPRegistry(TypedDict)
+```
+
+Configuration for Google Container Registry (GCR) or Artifact Registry.
+
+
+## TemplateType
+
+```python
+class TemplateType(TypedDict)
+```
+
+Internal representation of a template for the E2B build API.
+
+
+## BuildInfo
+
+```python
+@dataclass
+class BuildInfo()
+```
+
+Information about a built template.
+
+
+
+
+## LogEntry
+
+```python
+@dataclass
+class LogEntry()
+```
+
+Represents a single log entry from the template build process.
+
+
+## LogEntryStart
+
+```python
+@dataclass
+class LogEntryStart(LogEntry)
+```
+
+Special log entry indicating the start of a build process.
+
+
+## LogEntryEnd
+
+```python
+@dataclass
+class LogEntryEnd(LogEntry)
+```
+
+Special log entry indicating the end of a build process.
+
+
+### TIMER\_UPDATE\_INTERVAL\_MS
+
+Default minimum log level to display.
+
+
+### DEFAULT\_LEVEL
+
+Colored labels for each log level.
+
+
+### levels
+
+Numeric ordering of log levels for comparison (lower = less severe).
+
+
+### set\_interval
+
+```python
+def set_interval(func, interval)
+```
+
+Returns a stop function that can be called to cancel the interval.
+
+Similar to JavaScript's setInterval.
+
+**Arguments**:
+
+- `func`: Function to execute at each interval
+- `interval`: Interval duration in **seconds**
+
+**Returns**:
+
+Stop function that can be called to cancel the interval
+
+
+### default\_build\_logger
+
+```python
+def default_build_logger(
+ min_level: Optional[LogEntryLevel] = None
+) -> Callable[[LogEntry], None]
+```
+
+Create a default build logger with animated timer display.
+
+**Arguments**:
+
+- `min_level`: Minimum log level to display (default: 'info')
+
+**Returns**:
+
+Logger function that accepts LogEntry instances
+Example
+```python
+from e2b import Template, default_build_logger
+
+template = Template().from_python_image()
+
+```
+
+
+
+
+### normalize\_build\_arguments
+
+```python
+def normalize_build_arguments(name: Optional[str] = None,
+ alias: Optional[str] = None) -> str
+```
+
+Normalize build arguments from different parameter signatures.
+
+Handles string name or legacy alias parameter.
+
+**Arguments**:
+
+- `name`: Template name in 'name' or 'name:tag' format
+- `alias`: (Deprecated) Alias name for the template. Use name instead.
+
+**Raises**:
+
+- `TemplateException`: If no template name is provided
+
+**Returns**:
+
+Normalized template name
+
+
+### read\_dockerignore
+
+```python
+def read_dockerignore(context_path: str) -> List[str]
+```
+
+Read and parse a .dockerignore file.
+
+**Arguments**:
+
+- `context_path`: Directory path containing the .dockerignore file
+
+**Returns**:
+
+Array of ignore patterns (empty lines and comments are filtered out)
+
+
+### normalize\_path
+
+```python
+def normalize_path(path: str) -> str
+```
+
+Normalize path separators to forward slashes for glob patterns (glob expects / even on Windows).
+
+**Arguments**:
+
+- `path`: The path to normalize
+
+**Returns**:
+
+The normalized path
+
+
+### get\_all\_files\_in\_path
+
+```python
+def get_all_files_in_path(src: str,
+ context_path: str,
+ ignore_patterns: List[str],
+ include_directories: bool = True) -> List[str]
+```
+
+Get all files for a given path and ignore patterns.
+
+**Arguments**:
+
+- `src`: Path to the source directory
+- `context_path`: Base directory for resolving relative paths
+- `ignore_patterns`: Ignore patterns
+- `include_directories`: Whether to include directories
+
+**Returns**:
+
+Array of files
+
+
+### calculate\_files\_hash
+
+```python
+def calculate_files_hash(src: str, dest: str, context_path: str,
+ ignore_patterns: List[str], resolve_symlinks: bool,
+ stack_trace: Optional[TracebackType]) -> str
+```
+
+Calculate a hash of files being copied to detect changes for cache invalidation.
+
+The hash includes file content, metadata (mode, size), and relative paths.
+Note: uid, gid, and mtime are excluded to ensure stable hashes across environments.
+
+**Arguments**:
+
+- `src`: Source path pattern for files to copy
+- `dest`: Destination path where files will be copied
+- `context_path`: Base directory for resolving relative paths
+- `ignore_patterns`: Glob patterns to ignore
+- `resolve_symlinks`: Whether to resolve symbolic links when hashing
+- `stack_trace`: Optional stack trace for error reporting
+
+**Raises**:
+
+- `ValueError`: If no files match the source pattern
+
+**Returns**:
+
+Hex string hash of all files
+
+
+### tar\_file\_stream
+
+```python
+def tar_file_stream(file_name: str, file_context_path: str,
+ ignore_patterns: List[str],
+ resolve_symlinks: bool) -> io.BytesIO
+```
+
+Create a tar stream of files matching a pattern.
+
+**Arguments**:
+
+- `file_name`: Glob pattern for files to include
+- `file_context_path`: Base directory for resolving file paths
+- `ignore_patterns`: Ignore patterns
+- `resolve_symlinks`: Whether to resolve symbolic links
+
+**Returns**:
+
+Tar stream
+
+
+### strip\_ansi\_escape\_codes
+
+```python
+def strip_ansi_escape_codes(text: str) -> str
+```
+
+Strip ANSI escape codes from a string.
+
+Source: https://github.com/chalk/ansi-regex/blob/main/index.js
+
+**Arguments**:
+
+- `text`: String with ANSI escape codes
+
+**Returns**:
+
+String without ANSI escape codes
+
+
+### get\_caller\_frame
+
+```python
+def get_caller_frame(depth: int) -> Optional[FrameType]
+```
+
+Get the caller's stack frame at a specific depth.
+
+This is used to provide better error messages and debugging information
+by tracking where template methods were called from in user code.
+
+**Arguments**:
+
+- `depth`: The depth of the stack trace to retrieve
+
+**Returns**:
+
+The caller frame, or None if not available
+
+
+### get\_caller\_directory
+
+```python
+def get_caller_directory(depth: int) -> Optional[str]
+```
+
+Get the directory of the caller at a specific stack depth.
+
+This is used to determine the file_context_path when creating a template,
+so file paths are resolved relative to the user's template file location.
+
+**Arguments**:
+
+- `depth`: The depth of the stack trace
+
+**Returns**:
+
+The caller's directory path, or None if not available
+
+
+### pad\_octal
+
+```python
+def pad_octal(mode: int) -> str
+```
+
+Convert a numeric file mode to a zero-padded octal string.
+
+**Arguments**:
+
+- `mode`: File mode as a number (e.g., 493 for 0o755)
+
+**Returns**:
+
+Zero-padded 4-digit octal string (e.g., "0755")
+Example
+```python
+pad_octal(0o755) # Returns "0755"
+pad_octal(0o644) # Returns "0644"
+```
+
+
+### get\_build\_step\_index
+
+```python
+def get_build_step_index(step: str, stack_traces_length: int) -> int
+```
+
+Get the array index for a build step based on its name.
+
+Special steps:
+- BASE_STEP_NAME: Returns 0 (first step)
+- FINALIZE_STEP_NAME: Returns the last index
+- Numeric strings: Converted to number
+
+**Arguments**:
+
+- `step`: Build step name or number as string
+- `stack_traces_length`: Total number of stack traces (used for FINALIZE_STEP_NAME)
+
+**Returns**:
+
+Index for the build step
+
+
+### read\_gcp\_service\_account\_json
+
+```python
+def read_gcp_service_account_json(context_path: str,
+ path_or_content: Union[str, dict]) -> str
+```
+
+Read GCP service account JSON from a file or object.
+
+**Arguments**:
+
+- `context_path`: Base directory for resolving relative file paths
+- `path_or_content`: Either a path to a JSON file or a service account object
+
+**Returns**:
+
+Service account JSON as a string
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/logger/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/logger/page.mdx
new file mode 100644
index 000000000..4d41b149b
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/logger/page.mdx
@@ -0,0 +1,93 @@
+
+
+
+## LogEntry
+
+```python
+@dataclass
+class LogEntry()
+```
+
+Represents a single log entry from the template build process.
+
+
+## LogEntryStart
+
+```python
+@dataclass
+class LogEntryStart(LogEntry)
+```
+
+Special log entry indicating the start of a build process.
+
+
+## LogEntryEnd
+
+```python
+@dataclass
+class LogEntryEnd(LogEntry)
+```
+
+Special log entry indicating the end of a build process.
+
+
+### TIMER\_UPDATE\_INTERVAL\_MS
+
+Default minimum log level to display.
+
+
+### DEFAULT\_LEVEL
+
+Colored labels for each log level.
+
+
+### levels
+
+Numeric ordering of log levels for comparison (lower = less severe).
+
+
+### set\_interval
+
+```python
+def set_interval(func, interval)
+```
+
+Returns a stop function that can be called to cancel the interval.
+
+Similar to JavaScript's setInterval.
+
+**Arguments**:
+
+- `func`: Function to execute at each interval
+- `interval`: Interval duration in **seconds**
+
+**Returns**:
+
+Stop function that can be called to cancel the interval
+
+
+### default\_build\_logger
+
+```python
+def default_build_logger(
+ min_level: Optional[LogEntryLevel] = None
+) -> Callable[[LogEntry], None]
+```
+
+Create a default build logger with animated timer display.
+
+**Arguments**:
+
+- `min_level`: Minimum log level to display (default: 'info')
+
+**Returns**:
+
+Logger function that accepts LogEntry instances
+Example
+```python
+from e2b import Template, default_build_logger
+
+template = Template().from_python_image()
+
+```
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/page.mdx
new file mode 100644
index 000000000..8213835c8
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/page.mdx
@@ -0,0 +1,269 @@
+
+
+
+## AsyncTemplate
+
+```python
+class AsyncTemplate(TemplateBase)
+```
+
+Asynchronous template builder for E2B sandboxes.
+
+
+### build
+
+```python
+@staticmethod
+async def build(template: TemplateClass,
+ name: Optional[str] = None,
+ *,
+ alias: Optional[str] = None,
+ tags: Optional[List[str]] = None,
+ cpu_count: int = 2,
+ memory_mb: int = 1024,
+ skip_cache: bool = False,
+ on_build_logs: Optional[Callable[[LogEntry], None]] = None,
+ **opts: Unpack[ApiParams]) -> BuildInfo
+```
+
+Build and deploy a template to E2B infrastructure.
+
+**Arguments**:
+
+- `template`: The template to build
+- `name`: Template name in 'name' or 'name:tag' format
+- `alias`: (Deprecated) Alias name for the template. Use name instead.
+- `tags`: Optional additional tags to assign to the template
+- `cpu_count`: Number of CPUs allocated to the sandbox
+- `memory_mb`: Amount of memory in MB allocated to the sandbox
+- `skip_cache`: If True, forces a complete rebuild ignoring cache
+- `on_build_logs`: Callback function to receive build logs during the build process
+Example
+```python
+from e2b import AsyncTemplate
+
+template = (
+ AsyncTemplate()
+ .from_python_image('3')
+ .copy('requirements.txt', '/home/user/')
+ .run_cmd('pip install -r /home/user/requirements.txt')
+)
+
+await AsyncTemplate.build(template, 'my-python-env:v1.0')
+
+await AsyncTemplate.build(template, 'my-python-env', tags=['v1.1.0', 'stable'])
+```
+
+
+### build\_in\_background
+
+```python
+@staticmethod
+async def build_in_background(template: TemplateClass,
+ name: Optional[str] = None,
+ *,
+ alias: Optional[str] = None,
+ tags: Optional[List[str]] = None,
+ cpu_count: int = 2,
+ memory_mb: int = 1024,
+ skip_cache: bool = False,
+ on_build_logs: Optional[Callable[[LogEntry],
+ None]] = None,
+ **opts: Unpack[ApiParams]) -> BuildInfo
+```
+
+Build and deploy a template to E2B infrastructure without waiting for completion.
+
+**Arguments**:
+
+- `template`: The template to build
+- `name`: Template name in 'name' or 'name:tag' format
+- `alias`: (Deprecated) Alias name for the template. Use name instead.
+- `tags`: Optional additional tags to assign to the template
+- `cpu_count`: Number of CPUs allocated to the sandbox
+- `memory_mb`: Amount of memory in MB allocated to the sandbox
+- `skip_cache`: If True, forces a complete rebuild ignoring cache
+
+**Returns**:
+
+BuildInfo containing the template ID and build ID
+Example
+```python
+from e2b import AsyncTemplate
+
+template = (
+ AsyncTemplate()
+ .from_python_image('3')
+ .run_cmd('echo "test"')
+ .set_start_cmd('echo "Hello"', 'sleep 1')
+)
+
+build_info = await AsyncTemplate.build_in_background(template, 'my-python-env:v1.0')
+
+build_info = await AsyncTemplate.build_in_background(template, 'my-python-env', tags=['v1.1.0', 'stable'])
+```
+
+
+### get\_build\_status
+
+```python
+@staticmethod
+async def get_build_status(build_info: BuildInfo,
+ logs_offset: int = 0,
+ **opts: Unpack[ApiParams])
+```
+
+Get the status of a build.
+
+**Arguments**:
+
+- `build_info`: Build identifiers returned from build_in_background
+- `logs_offset`: Offset for fetching logs
+
+**Returns**:
+
+TemplateBuild containing the build status and logs
+Example
+```python
+from e2b import AsyncTemplate
+
+build_info = await AsyncTemplate.build_in_background(template, alias='my-template')
+status = await AsyncTemplate.get_build_status(build_info, logs_offset=0)
+```
+
+
+### alias\_exists
+
+```python
+@staticmethod
+async def alias_exists(alias: str, **opts: Unpack[ApiParams]) -> bool
+```
+
+Check if a template with the given alias exists.
+
+**Arguments**:
+
+- `alias`: Template alias to check
+
+**Returns**:
+
+True if the alias exists, False otherwise
+Example
+```python
+from e2b import AsyncTemplate
+
+exists = await AsyncTemplate.alias_exists('base')
+if exists:
+ print('Template exists!')
+```
+
+
+### assign\_tags
+
+```python
+@staticmethod
+async def assign_tags(target_name: str, tags: Union[str, List[str]],
+ **opts: Unpack[ApiParams]) -> TemplateTagInfo
+```
+
+Assign tag(s) to an existing template build.
+
+**Arguments**:
+
+- `target_name`: Template name in 'name:tag' format (the source build to tag from)
+- `tags`: Tag or tags to assign
+
+**Returns**:
+
+TemplateTagInfo with build_id and assigned tags
+Example
+```python
+from e2b import AsyncTemplate
+
+result = await AsyncTemplate.assign_tags('my-template:v1.0', 'production')
+
+result = await AsyncTemplate.assign_tags('my-template:v1.0', ['production', 'stable'])
+```
+
+
+### remove\_tags
+
+```python
+@staticmethod
+async def remove_tags(name: str, tags: Union[str, List[str]],
+ **opts: Unpack[ApiParams]) -> None
+```
+
+Remove tag(s) from a template.
+
+**Arguments**:
+
+- `name`: Template name
+- `tags`: Tag or tags to remove
+Example
+```python
+from e2b import AsyncTemplate
+
+await AsyncTemplate.remove_tags('my-template', 'production')
+
+await AsyncTemplate.remove_tags('my-template', ['production', 'stable'])
+```
+
+
+
+
+### check\_alias\_exists
+
+```python
+async def check_alias_exists(client: AuthenticatedClient, alias: str) -> bool
+```
+
+Check if a template with the given alias exists.
+
+**Arguments**:
+
+- `client` - Authenticated API client
+- `alias` - Template alias to check
+
+
+**Returns**:
+
+ True if the alias exists, False otherwise
+
+
+### assign\_tags
+
+```python
+async def assign_tags(client: AuthenticatedClient, target_name: str,
+ tags: List[str]) -> TemplateTagInfo
+```
+
+Assign tag(s) to an existing template build.
+
+**Arguments**:
+
+- `client` - Authenticated API client
+- `target_name` - Template name in 'name:tag' format (the source build to tag from)
+- `tags` - Tags to assign
+
+
+**Returns**:
+
+ TemplateTagInfo with build_id and assigned tags
+
+
+### remove\_tags
+
+```python
+async def remove_tags(client: AuthenticatedClient, name: str,
+ tags: List[str]) -> None
+```
+
+Remove tag(s) from a template.
+
+**Arguments**:
+
+- `client` - Authenticated API client
+- `name` - Template name
+- `tags` - List of tags to remove
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/readycmd/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/readycmd/page.mdx
new file mode 100644
index 000000000..2116be854
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_async/readycmd/page.mdx
@@ -0,0 +1,157 @@
+
+
+
+## ReadyCmd
+
+```python
+class ReadyCmd()
+```
+
+Wrapper class for ready check commands.
+
+
+### wait\_for\_port
+
+```python
+def wait_for_port(port: int)
+```
+
+Wait for a port to be listening.
+
+Uses `ss` command to check if a port is open and listening.
+
+**Arguments**:
+
+- `port`: Port number to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the port
+Example
+```python
+from e2b import Template, wait_for_port
+
+template = (
+ Template()
+ .from_python_image()
+ .set_start_cmd('python -m http.server 8000', wait_for_port(8000))
+)
+```
+
+
+### wait\_for\_url
+
+```python
+def wait_for_url(url: str, status_code: int = 200)
+```
+
+Wait for a URL to return a specific HTTP status code.
+
+Uses `curl` to make HTTP requests and check the response status.
+
+**Arguments**:
+
+- `url`: URL to check (e.g., 'http://localhost:3000/health')
+- `status_code`: Expected HTTP status code (default: 200)
+
+**Returns**:
+
+ReadyCmd that checks the URL
+Example
+```python
+from e2b import Template, wait_for_url
+
+template = (
+ Template()
+ .from_node_image()
+ .set_start_cmd('npm start', wait_for_url('http://localhost:3000/health'))
+)
+```
+
+
+### wait\_for\_process
+
+```python
+def wait_for_process(process_name: str)
+```
+
+Wait for a process with a specific name to be running.
+
+Uses `pgrep` to check if a process exists.
+
+**Arguments**:
+
+- `process_name`: Name of the process to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the process
+Example
+```python
+from e2b import Template, wait_for_process
+
+template = (
+ Template()
+ .from_base_image()
+ .set_start_cmd('./my-daemon', wait_for_process('my-daemon'))
+)
+```
+
+
+### wait\_for\_file
+
+```python
+def wait_for_file(filename: str)
+```
+
+Wait for a file to exist.
+
+Uses shell test command to check file existence.
+
+**Arguments**:
+
+- `filename`: Path to the file to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the file
+Example
+```python
+from e2b import Template, wait_for_file
+
+template = (
+ Template()
+ .from_base_image()
+ .set_start_cmd('./init.sh', wait_for_file('/tmp/ready'))
+)
+```
+
+
+### wait\_for\_timeout
+
+```python
+def wait_for_timeout(timeout: int)
+```
+
+Wait for a specified timeout before considering the sandbox ready.
+
+Uses `sleep` command to wait for a fixed duration.
+
+**Arguments**:
+
+- `timeout`: Time to wait in **milliseconds** (minimum: 1000ms / 1 second)
+
+**Returns**:
+
+ReadyCmd that waits for the specified duration
+Example
+```python
+from e2b import Template, wait_for_timeout
+
+template = (
+ Template()
+ .from_node_image()
+ .set_start_cmd('npm start', wait_for_timeout(5000)) # Wait 5 seconds
+)
+```
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/logger/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/logger/page.mdx
new file mode 100644
index 000000000..4d41b149b
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/logger/page.mdx
@@ -0,0 +1,93 @@
+
+
+
+## LogEntry
+
+```python
+@dataclass
+class LogEntry()
+```
+
+Represents a single log entry from the template build process.
+
+
+## LogEntryStart
+
+```python
+@dataclass
+class LogEntryStart(LogEntry)
+```
+
+Special log entry indicating the start of a build process.
+
+
+## LogEntryEnd
+
+```python
+@dataclass
+class LogEntryEnd(LogEntry)
+```
+
+Special log entry indicating the end of a build process.
+
+
+### TIMER\_UPDATE\_INTERVAL\_MS
+
+Default minimum log level to display.
+
+
+### DEFAULT\_LEVEL
+
+Colored labels for each log level.
+
+
+### levels
+
+Numeric ordering of log levels for comparison (lower = less severe).
+
+
+### set\_interval
+
+```python
+def set_interval(func, interval)
+```
+
+Returns a stop function that can be called to cancel the interval.
+
+Similar to JavaScript's setInterval.
+
+**Arguments**:
+
+- `func`: Function to execute at each interval
+- `interval`: Interval duration in **seconds**
+
+**Returns**:
+
+Stop function that can be called to cancel the interval
+
+
+### default\_build\_logger
+
+```python
+def default_build_logger(
+ min_level: Optional[LogEntryLevel] = None
+) -> Callable[[LogEntry], None]
+```
+
+Create a default build logger with animated timer display.
+
+**Arguments**:
+
+- `min_level`: Minimum log level to display (default: 'info')
+
+**Returns**:
+
+Logger function that accepts LogEntry instances
+Example
+```python
+from e2b import Template, default_build_logger
+
+template = Template().from_python_image()
+
+```
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/page.mdx
new file mode 100644
index 000000000..a5f55e025
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/page.mdx
@@ -0,0 +1,269 @@
+
+
+
+## Template
+
+```python
+class Template(TemplateBase)
+```
+
+Synchronous template builder for E2B sandboxes.
+
+
+### build
+
+```python
+@staticmethod
+def build(template: TemplateClass,
+ name: Optional[str] = None,
+ *,
+ alias: Optional[str] = None,
+ tags: Optional[List[str]] = None,
+ cpu_count: int = 2,
+ memory_mb: int = 1024,
+ skip_cache: bool = False,
+ on_build_logs: Optional[Callable[[LogEntry], None]] = None,
+ **opts: Unpack[ApiParams]) -> BuildInfo
+```
+
+Build and deploy a template to E2B infrastructure.
+
+**Arguments**:
+
+- `template`: The template to build
+- `name`: Template name in 'name' or 'name:tag' format
+- `alias`: (Deprecated) Alias name for the template. Use name instead.
+- `tags`: Optional additional tags to assign to the template
+- `cpu_count`: Number of CPUs allocated to the sandbox
+- `memory_mb`: Amount of memory in MB allocated to the sandbox
+- `skip_cache`: If True, forces a complete rebuild ignoring cache
+- `on_build_logs`: Callback function to receive build logs during the build process
+Example
+```python
+from e2b import Template
+
+template = (
+ Template()
+ .from_python_image('3')
+ .copy('requirements.txt', '/home/user/')
+ .run_cmd('pip install -r /home/user/requirements.txt')
+)
+
+Template.build(template, 'my-python-env:v1.0')
+
+Template.build(template, 'my-python-env', tags=['v1.1.0', 'stable'])
+```
+
+
+### build\_in\_background
+
+```python
+@staticmethod
+def build_in_background(template: TemplateClass,
+ name: Optional[str] = None,
+ *,
+ alias: Optional[str] = None,
+ tags: Optional[List[str]] = None,
+ cpu_count: int = 2,
+ memory_mb: int = 1024,
+ skip_cache: bool = False,
+ on_build_logs: Optional[Callable[[LogEntry],
+ None]] = None,
+ **opts: Unpack[ApiParams]) -> BuildInfo
+```
+
+Build and deploy a template to E2B infrastructure without waiting for completion.
+
+**Arguments**:
+
+- `template`: The template to build
+- `name`: Template name in 'name' or 'name:tag' format
+- `alias`: (Deprecated) Alias name for the template. Use name instead.
+- `tags`: Optional additional tags to assign to the template
+- `cpu_count`: Number of CPUs allocated to the sandbox
+- `memory_mb`: Amount of memory in MB allocated to the sandbox
+- `skip_cache`: If True, forces a complete rebuild ignoring cache
+
+**Returns**:
+
+BuildInfo containing the template ID and build ID
+Example
+```python
+from e2b import Template
+
+template = (
+ Template()
+ .from_python_image('3')
+ .run_cmd('echo "test"')
+ .set_start_cmd('echo "Hello"', 'sleep 1')
+)
+
+build_info = Template.build_in_background(template, 'my-python-env:v1.0')
+
+build_info = Template.build_in_background(template, 'my-python-env', tags=['v1.1.0', 'stable'])
+```
+
+
+### get\_build\_status
+
+```python
+@staticmethod
+def get_build_status(build_info: BuildInfo,
+ logs_offset: int = 0,
+ **opts: Unpack[ApiParams])
+```
+
+Get the status of a build.
+
+**Arguments**:
+
+- `build_info`: Build identifiers returned from build_in_background
+- `logs_offset`: Offset for fetching logs
+
+**Returns**:
+
+TemplateBuild containing the build status and logs
+Example
+```python
+from e2b import Template
+
+build_info = Template.build_in_background(template, alias='my-template')
+status = Template.get_build_status(build_info, logs_offset=0)
+```
+
+
+### alias\_exists
+
+```python
+@staticmethod
+def alias_exists(alias: str, **opts: Unpack[ApiParams]) -> bool
+```
+
+Check if a template with the given alias exists.
+
+**Arguments**:
+
+- `alias`: Template alias to check
+
+**Returns**:
+
+True if the alias exists, False otherwise
+Example
+```python
+from e2b import Template
+
+exists = Template.alias_exists('base')
+if exists:
+ print('Template exists!')
+```
+
+
+### assign\_tags
+
+```python
+@staticmethod
+def assign_tags(target_name: str, tags: Union[str, List[str]],
+ **opts: Unpack[ApiParams]) -> TemplateTagInfo
+```
+
+Assign tag(s) to an existing template build.
+
+**Arguments**:
+
+- `target_name`: Template name in 'name:tag' format (the source build to tag from)
+- `tags`: Tag or tags to assign
+
+**Returns**:
+
+TemplateTagInfo with build_id and assigned tags
+Example
+```python
+from e2b import Template
+
+result = Template.assign_tags('my-template:v1.0', 'production')
+
+result = Template.assign_tags('my-template:v1.0', ['production', 'stable'])
+```
+
+
+### remove\_tags
+
+```python
+@staticmethod
+def remove_tags(name: str, tags: Union[str, List[str]],
+ **opts: Unpack[ApiParams]) -> None
+```
+
+Remove tag(s) from a template.
+
+**Arguments**:
+
+- `name`: Template name
+- `tags`: Tag or tags to remove
+Example
+```python
+from e2b import Template
+
+Template.remove_tags('my-template', 'production')
+
+Template.remove_tags('my-template', ['production', 'stable'])
+```
+
+
+
+
+### check\_alias\_exists
+
+```python
+def check_alias_exists(client: AuthenticatedClient, alias: str) -> bool
+```
+
+Check if a template with the given alias exists.
+
+**Arguments**:
+
+- `client` - Authenticated API client
+- `alias` - Template alias to check
+
+
+**Returns**:
+
+ True if the alias exists, False otherwise
+
+
+### assign\_tags
+
+```python
+def assign_tags(client: AuthenticatedClient, target_name: str,
+ tags: List[str]) -> TemplateTagInfo
+```
+
+Assign tag(s) to an existing template build.
+
+**Arguments**:
+
+- `client` - Authenticated API client
+- `target_name` - Template name in 'name:tag' format (the source build to tag from)
+- `tags` - Tags to assign
+
+
+**Returns**:
+
+ TemplateTagInfo with build_id and assigned tags
+
+
+### remove\_tags
+
+```python
+def remove_tags(client: AuthenticatedClient, name: str,
+ tags: List[str]) -> None
+```
+
+Remove tag(s) from a template.
+
+**Arguments**:
+
+- `client` - Authenticated API client
+- `name` - Template name
+- `tags` - List of tags to remove
+
diff --git a/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/readycmd/page.mdx b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/readycmd/page.mdx
new file mode 100644
index 000000000..2116be854
--- /dev/null
+++ b/apps/web/src/app/(docs)/docs/sdk-reference/python-sdk/v2.12.0/template_sync/readycmd/page.mdx
@@ -0,0 +1,157 @@
+
+
+
+## ReadyCmd
+
+```python
+class ReadyCmd()
+```
+
+Wrapper class for ready check commands.
+
+
+### wait\_for\_port
+
+```python
+def wait_for_port(port: int)
+```
+
+Wait for a port to be listening.
+
+Uses `ss` command to check if a port is open and listening.
+
+**Arguments**:
+
+- `port`: Port number to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the port
+Example
+```python
+from e2b import Template, wait_for_port
+
+template = (
+ Template()
+ .from_python_image()
+ .set_start_cmd('python -m http.server 8000', wait_for_port(8000))
+)
+```
+
+
+### wait\_for\_url
+
+```python
+def wait_for_url(url: str, status_code: int = 200)
+```
+
+Wait for a URL to return a specific HTTP status code.
+
+Uses `curl` to make HTTP requests and check the response status.
+
+**Arguments**:
+
+- `url`: URL to check (e.g., 'http://localhost:3000/health')
+- `status_code`: Expected HTTP status code (default: 200)
+
+**Returns**:
+
+ReadyCmd that checks the URL
+Example
+```python
+from e2b import Template, wait_for_url
+
+template = (
+ Template()
+ .from_node_image()
+ .set_start_cmd('npm start', wait_for_url('http://localhost:3000/health'))
+)
+```
+
+
+### wait\_for\_process
+
+```python
+def wait_for_process(process_name: str)
+```
+
+Wait for a process with a specific name to be running.
+
+Uses `pgrep` to check if a process exists.
+
+**Arguments**:
+
+- `process_name`: Name of the process to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the process
+Example
+```python
+from e2b import Template, wait_for_process
+
+template = (
+ Template()
+ .from_base_image()
+ .set_start_cmd('./my-daemon', wait_for_process('my-daemon'))
+)
+```
+
+
+### wait\_for\_file
+
+```python
+def wait_for_file(filename: str)
+```
+
+Wait for a file to exist.
+
+Uses shell test command to check file existence.
+
+**Arguments**:
+
+- `filename`: Path to the file to wait for
+
+**Returns**:
+
+ReadyCmd that checks for the file
+Example
+```python
+from e2b import Template, wait_for_file
+
+template = (
+ Template()
+ .from_base_image()
+ .set_start_cmd('./init.sh', wait_for_file('/tmp/ready'))
+)
+```
+
+
+### wait\_for\_timeout
+
+```python
+def wait_for_timeout(timeout: int)
+```
+
+Wait for a specified timeout before considering the sandbox ready.
+
+Uses `sleep` command to wait for a fixed duration.
+
+**Arguments**:
+
+- `timeout`: Time to wait in **milliseconds** (minimum: 1000ms / 1 second)
+
+**Returns**:
+
+ReadyCmd that waits for the specified duration
+Example
+```python
+from e2b import Template, wait_for_timeout
+
+template = (
+ Template()
+ .from_node_image()
+ .set_start_cmd('npm start', wait_for_timeout(5000)) # Wait 5 seconds
+)
+```
+
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 490945f2b..05bb601da 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@e2b/cli",
- "version": "2.5.0",
+ "version": "2.5.1",
"description": "CLI for managing e2b sandbox templates",
"homepage": "https://e2b.dev",
"license": "MIT",
@@ -86,7 +86,7 @@
"commander": "^11.1.0",
"console-table-printer": "^2.11.2",
"dockerfile-ast": "^0.6.1",
- "e2b": "^2.8.4",
+ "e2b": "^2.11.0",
"handlebars": "^4.7.8",
"inquirer": "^12.10.0",
"open": "^9.1.0",
diff --git a/packages/js-sdk/package.json b/packages/js-sdk/package.json
index ea47132da..d56fbdd64 100644
--- a/packages/js-sdk/package.json
+++ b/packages/js-sdk/package.json
@@ -1,6 +1,6 @@
{
"name": "e2b",
- "version": "2.10.5",
+ "version": "2.11.0",
"description": "E2B SDK that give agents cloud environments",
"homepage": "https://e2b.dev",
"license": "MIT",
diff --git a/packages/python-sdk/package.json b/packages/python-sdk/package.json
index 1b02250b5..e3ec9492f 100644
--- a/packages/python-sdk/package.json
+++ b/packages/python-sdk/package.json
@@ -1,7 +1,7 @@
{
"name": "@e2b/python-sdk",
"private": true,
- "version": "2.11.0",
+ "version": "2.12.0",
"scripts": {
"example": "poetry run python example.py",
"test": "poetry run pytest -n 4 --verbose -x",
diff --git a/packages/python-sdk/pyproject.toml b/packages/python-sdk/pyproject.toml
index 1b02a88fd..4a7a65f72 100644
--- a/packages/python-sdk/pyproject.toml
+++ b/packages/python-sdk/pyproject.toml
@@ -1,6 +1,6 @@
[tool.poetry]
name = "e2b"
-version = "2.11.0"
+version = "2.12.0"
description = "E2B SDK that give agents cloud environments"
authors = ["e2b <[email protected]>"]
license = "MIT"
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 7bab543b6..5c50928c4 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -118,8 +118,8 @@ importers:
specifier: ^1.2.1
version: 1.2.1
e2b:
- specifier: ^2.10.5
- version: 2.10.5
+ specifier: ^2.11.0
+ version: 2.11.0
fast-glob:
specifier: ^3.3.0
version: 3.3.1
@@ -275,8 +275,8 @@ importers:
specifier: ^0.6.1
version: 0.6.1
e2b:
- specifier: ^2.8.4
- version: 2.8.4
+ specifier: ^2.11.0
+ version: 2.11.0
handlebars:
specifier: ^4.7.8
version: 4.7.8
@@ -4055,12 +4055,8 @@ packages:
resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
engines: {node: '>= 0.4'}
- resolution: {integrity: sha512-hhvfXQs0ENiqSxg0FHdhtz6v8kfoAefFWkQHaHeCIRW1rA/HgWH2X1re8KFDiv3okXsxPIxX8AsJTvOeVtcItQ==}
- engines: {node: '>=20'}
-
- resolution: {integrity: sha512-InHLjwWYM3eWfr/YYP1NnbjZ6ZojydzfFnY1JMX2oDM5dxO6EPriqIw2ObFJPCwRsrpZelnHeMe19HeJJmVBvg==}
+ resolution: {integrity: sha512-S4miCMDmObh9BDkXy76TUXlnVg4oXO1m1XbAYSob0tGAgKPr1yeOZ0VBGnbRQQQ4GnLkXX99Zx4HUSO9cIahKw==}
engines: {node: '>=20'}
@@ -7026,11 +7022,6 @@ packages:
engines: {node: '>=10'}
deprecated: Old versions of tar are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exhorbitant rates) by contacting [email protected]
- resolution: {integrity: sha512-7NyxrTE4Anh8km8iEy7o0QYPs+0JKBTj5ZaqHg6B39erLg0qYXN3BijtShwbsNSvQ+LN75+KV+C4QR/f6Gwnpg==}
- engines: {node: '>=18'}
- deprecated: Old versions of tar are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exhorbitant rates) by contacting [email protected]
-
resolution: {integrity: sha512-AN04xbWGrSTDmVwlI4/GTlIIwMFk/XEv7uL8aa57zuvRy6s4hdBed+lVq2fAZ89XDa7Us3ANXcE3Tvqvja1kTA==}
engines: {node: '>=18'}
@@ -11921,7 +11912,7 @@ snapshots:
es-errors: 1.3.0
gopd: 1.2.0
dependencies:
'@bufbuild/protobuf': 2.6.2
'@connectrpc/connect': 2.0.0-rc.3(@bufbuild/[email protected])
@@ -11934,19 +11925,6 @@ snapshots:
platform: 1.3.6
tar: 7.5.4
- dependencies:
- '@bufbuild/protobuf': 2.6.2
- '@connectrpc/connect': 2.0.0-rc.3(@bufbuild/[email protected])
- '@connectrpc/connect-web': 2.0.0-rc.3(@bufbuild/[email protected])(@connectrpc/[email protected](@bufbuild/[email protected]))
- chalk: 5.3.0
- compare-versions: 6.1.1
- dockerfile-ast: 0.7.1
- glob: 11.1.0
- openapi-fetch: 0.14.1
- platform: 1.3.6
- tar: 7.5.2
-
@@ -15646,14 +15624,6 @@ snapshots:
mkdirp: 1.0.4
yallist: 4.0.0
- dependencies:
- '@isaacs/fs-minipass': 4.0.1
- chownr: 3.0.0
- minipass: 7.1.2
- minizlib: 3.1.0
- yallist: 5.0.0
-
dependencies:
'@isaacs/fs-minipass': 4.0.1