feat: add Volume CRUD operations to SDKs

[mishushakov]

Summary

Add Volume CRUD operations to both TypeScript and Python SDKs. Volumes are persistent storage that can be mounted to sandboxes. Includes create, list, get_info, and destroy methods. Sandbox creation now supports volumeMounts parameter.

• Updated OpenAPI spec with volume endpoints and schemas
• Generated API clients for both SDKs using codegen
• Implemented Volume class in TypeScript with static methods
• Implemented sync/async Volume classes in Python with same API
• Added volumeMounts support to Sandbox creation flow
• Added volume tag to codegen filters for spec filtering

Usage Examples

TypeScript

import { Volume, Sandbox } from 'e2b'

// Create a volume
const volume = await Volume.create('my-data')
console.log(volume.volumeId, volume.name)

// List all volumes
const volumes = await Volume.list()

// Get volume info
const info = await Volume.getInfo(volume.volumeId)

// File operations on a volume
await volume.writeFile('/data/hello.txt', 'Hello, World!')
const content = await volume.readFile('/data/hello.txt')

// Directory operations
await volume.makeDir('/data/subdir', { force: true })
const entries = await volume.list('/data')

// Check if a path exists
const exists = await volume.exists('/data/hello.txt')

// Get file/directory info
const stat = await volume.getInfo('/data/hello.txt')

// Remove files
await volume.remove('/data/hello.txt')
await volume.remove('/data/subdir', { recursive: true })

// Mount a volume to a sandbox
const sandbox = await Sandbox.create('base', {
  volumeMounts: {
    '/mnt/data': volume,       // mount by Volume instance
    '/mnt/other': 'other-vol', // mount by volume name
  },
})

// Connect to an existing volume
const existing = await Volume.connect(volume.volumeId)

// Destroy a volume
await Volume.destroy(volume.volumeId)

Python (async)

from e2b import AsyncSandbox, AsyncVolume

# Create a volume
volume = await AsyncVolume.create("my-data")
print(volume.volume_id, volume.name)

# List all volumes
volumes = await AsyncVolume.list()

# Get volume info
info = await AsyncVolume.get_info(volume.volume_id)

# File operations on a volume
await volume.write_file("/data/hello.txt", "Hello, World!")
content = await volume.read_file("/data/hello.txt")

# Directory operations
await volume.make_dir("/data/subdir", force=True)
entries = await volume.list("/data")

# Check if a path exists
exists = await volume.exists("/data/hello.txt")

# Get file/directory info
stat = await volume.get_info("/data/hello.txt")

# Remove files
await volume.remove("/data/hello.txt")
await volume.remove("/data/subdir", recursive=True)

# Mount a volume to a sandbox
sandbox = await AsyncSandbox.create(
    "base",
    volume_mounts={
        "/mnt/data": volume,       # mount by Volume instance
        "/mnt/other": "other-vol", # mount by volume name
    },
)

# Connect to an existing volume
existing = await AsyncVolume.connect(volume.volume_id)

# Destroy a volume
await AsyncVolume.destroy(volume.volume_id)

Python (sync)

from e2b import Sandbox, Volume

# Create a volume
volume = Volume.create("my-data")
print(volume.volume_id, volume.name)

# List all volumes
volumes = Volume.list()

# Get volume info
info = Volume.get_info(volume.volume_id)

# File operations on a volume
volume.write_file("/data/hello.txt", "Hello, World!")
content = volume.read_file("/data/hello.txt")

# Directory operations
volume.make_dir("/data/subdir", force=True)
entries = volume.list("/data")

# Check if a path exists
exists = volume.exists("/data/hello.txt")

# Get file/directory info
stat = volume.get_info("/data/hello.txt")

# Remove files
volume.remove("/data/hello.txt")
volume.remove("/data/subdir", recursive=True)

# Mount a volume to a sandbox
sandbox = Sandbox.create(
    "base",
    volume_mounts={
        "/mnt/data": volume,       # mount by Volume instance
        "/mnt/other": "other-vol", # mount by volume name
    },
)

# Connect to an existing volume
existing = Volume.connect(volume.volume_id)

# Destroy a volume
Volume.destroy(volume.volume_id)

Testing

• TypeScript build passes with no type errors
• Python imports work and classes are instantiable
• Both SDKs pass format and lint checks
• Generated API client models use correct field mappings (id/name)

---

Note

Medium Risk
Adds new volume-management and volume-content APIs plus sandbox volumeMounts/volume_mounts wiring, which introduces new network calls and token handling paths. Risk is moderate due to the size of generated client changes and expanded surface area, but it’s largely additive.

Overview
Adds Volumes support across the TypeScript and Python SDKs, including new Volume/AsyncVolume APIs for creating, listing, fetching, and destroying volumes, plus volume content operations (dir listing, metadata updates, upload/download, and delete) via a dedicated volume-content OpenAPI client.

Extends sandbox creation options to accept volumeMounts (JS) / volume_mounts (Python) and plumbs these through to the sandbox create request and returned SandboxInfo. Also updates generated API schemas (new /volumes endpoints; log query now supports level/search) and adds SDK tests/fixtures for volume behavior, along with codegen script updates and a changeset for minor version bumps.

^{Written by Cursor Bugbot for commit caabe40. This will update automatically on new commits. Configure here.}

[changeset-bot]

🦋 Changeset detected

Latest commit: fbe8d16

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@e2b/python-sdk	Minor
e2b	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[mishushakov]

@djeebus no need to review, it's a draft

[github-actions]

Package Artifacts

Built from a045db3. Download artifacts from this workflow run.

JS SDK (e2b@2.16.1-mishushakov-volume-crud-sdk.0):

npm install ./e2b-2.16.1-mishushakov-volume-crud-sdk.0.tgz

CLI (@e2b/cli@2.9.1-mishushakov-volume-crud-sdk.0):

npm install ./e2b-cli-2.9.1-mishushakov-volume-crud-sdk.0.tgz

Python SDK (e2b==2.17.0+mishushakov-volume-crud-sdk):

pip install ./e2b-2.17.0+mishushakov.volume.crud.sdk-py3-none-any.whl

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8ae99f53cf

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[cursor]

PR Summary

Medium Risk
Adds new Volume APIs (including file operations) and propagates volumeMounts into sandbox creation, which may affect request payload compatibility and error handling across both SDKs. Most changes are additive but span generated clients and core SDK entrypoints.

Overview
Adds first-class Volumes support to both SDKs: new volume CRUD endpoints/types are generated and exposed, plus a new JS Volume client with volume-content operations (list/read/write/mkdir/metadata/remove) backed by a dedicated volume API client.

Extends sandbox creation/listing in both JS and Python to accept/return volumeMounts and serialize mounts as {name, path}. Also updates the generated sandboxes logs API to support level/search filters, updates Python exports/exceptions, and refreshes codegen scripts/deps to include the new volumes tag and volume-content OpenAPI spec.

^{Written by Cursor Bugbot for commit fbe8d16. This will update automatically on new commits. Configure here.}