---
title: "Create a new volume"
method: POST
path: "/v1/deployments/storage/volumes"
tags: ["DeploymentsVolumes"]
---

# Create a new volume

`POST /v1/deployments/storage/volumes`

## Request

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

Create a new volume to preload files in deployments

## Request body

- CreateVolumeRequest
  - `content` VolumeContentRequest, required: Content specifies the new content to preload to this volume.
    - `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. Mutually exclusive with Origin
    - `type` 'files': Type is the content type (currently only "files" is supported which allows preloading files uploaded via Files API into the volume)
  - `name` string, required: Name is the unique identifier for the volume within the project
  - `type` 'readOnly', required

## Response `200`

Volume created successfully

- VolumeResponseItem
  - `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

## Other responses

- `400`: Invalid request
- `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/post.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)