---
title: "List all shared volumes"
method: GET
path: "/v1/compute/clusters/storage/volumes"
tags: ["SharedVolumeService"]
---

# List all shared volumes

`GET /v1/compute/clusters/storage/volumes`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/compute/clusters/storage/volumes`
- Auth: HTTP bearer

List all shared volumes.

## Query parameters

- `projectId` string: Optional UMS project ID to filter volumes by. When set, only volumes belonging to this project are returned. The caller must be a member of the project; otherwise the result set will be empty.

## Response `200`

OK

- GPUClustersSharedVolumes
  - `volumes` GPUClustersSharedVolume[], required
    - `volume_id` string, required: ID of the volume.
    - `volume_name` string, required: User provided name of the volume.
    - `size_tib` integer, required: Size of the volume in TiB.
    - `status` 'scheduled' | 'available' | 'bound' | 'provisioning' | 'deleting' | 'failed' | 'access_revoked' | 'unknown', required: Current status of the shared volume.

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/compute/clusters/storage/volumes/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)