---
title: "Get the list of project volumes"
method: GET
path: "/v1/deployments/storage/volumes"
tags: ["DeploymentsVolumes"]
---

# Get the list of project volumes

`GET /v1/deployments/storage/volumes`

## Request

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

Retrieve all volumes in your project

## Response `200`

List of volumes

- ListVolumesResponse
  - `data` VolumeResponseItem[]: Data is the array of volume items
    - `content` VolumeContent: Content currently available on a volume version.
      - `files` FileInfo[]: Files is the list of files to preload into the volume, if the volume content type is "files".
        - `last_modified` string: LastModified is the timestamp when the file was last modified
        - `name` string: Name is the filename including extension (e.g., "model_weights.bin")
        - `size` integer: Size is the file size in bytes
      - `origin` VolumeOrigin: External source Together copies into a new volume version.
        - `s3` S3Origin, required: S3 source configuration for volume sync.
          - `role_arn` string, required: IAM role ARN Together assumes to read the S3 bucket or prefix.
          - `uri` string, required: S3 bucket or prefix to copy into the volume.
      - `source_prefix` string: SourcePrefix is the file path prefix for the content to be preloaded into the volume
      - `type` 'files': Type is the content type (currently only "files" is supported which allows preloading files uploaded via Files API into the volume)
    - `created_at` string: CreatedAt is the ISO8601 timestamp when this volume was created
    - `current_version` integer: CurrentVersion is the current version number of this volume
    - `id` string: ID is the unique identifier for this volume
    - `mounted_by` string[]: MountedBy is the list of deployment IDs currently mounting current volume version
    - `name` string: Name is the name of the volume
    - `object` string: Object is the type identifier for this response (always "volume")
    - `status` 'ready' | 'pending' | 'syncing' | 'failed': Status of a volume version. Only ready versions can be mounted.
    - `status_message` string: Message explaining why the current volume version failed, when applicable.
    - `type` 'readOnly'
    - `updated_at` string: UpdatedAt is the ISO8601 timestamp when this volume was last updated
    - `version_history` object: VersionHistory contains previous versions of this volume, keyed by version number
  - `object` 'list': The object type, which is always `list`.

## Other responses

- `500`: Internal server error

## Changes

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

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/deployments/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)