---
title: "[Beta] List volumes"
method: GET
path: "/api/v2/sandboxes/volumes"
tags: ["sandboxes"]
---

# \[Beta\] List volumes

`GET /api/v2/sandboxes/volumes`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v2/sandboxes/volumes`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Tenant-Id`
  - HTTP bearer

**Beta:** This API is in active development and may change without notice. Requires sandbox volumes to be enabled for your workspace. List the workspace's sandbox volumes with their current attachments.

## Query parameters

- `page_size` integer
- `cursor` string
- `name_contains` string

## Response `200`

OK

- SandboxesVolumeListResponse
  - `items` SandboxesVolumeResponse[]
    - `attachments` SandboxesVolumeAttachmentResponse[]
      - `mount_path` string
      - `read_only` boolean
      - `sandbox_id` string
      - `sandbox_name` string
    - `created_at` string, date-time
    - `created_by` string
    - `description` string
    - `id` string
    - `labels` SandboxesLabels
    - `name` string
    - `size_bytes` integer
    - `source_volume_id` string
    - `status` string
    - `status_message` string
    - `updated_at` string, date-time
    - `updated_by` string
  - `next_cursor` string, nullable: Cursor for the next page, or null on the last page.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `500`: Internal Server Error

## Changes

- **2026-10-26** `dfe647d1748e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v2/sandboxes/volumes/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)