---
title: "Create a shared volume"
method: POST
path: "/v1/compute/clusters/storage/volumes"
tags: ["SharedVolumeService"]
---

# Create a shared volume

`POST /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

Instant Clusters supports long-lived, resizable in-DC shared storage with user data persistence.
You can dynamically create and attach volumes to your cluster at cluster creation time, and resize as your data grows.
All shared storage is backed by multi-NIC bare metal paths, ensuring high-throughput and low-latency performance for shared storage.

## Request body

- GPUClustersSharedVolumeCreateRequest: Request body for creating a shared volume.
  - `volume_name` string, required: User provided name of the volume.
  - `size_tib` integer, required: Volume size in whole tebibytes (TiB).
  - `region` string, required: Region name. Usable regions can be found from `clusters.list_regions()`
  - `is_lifecycle_independent` boolean: When true, the shared volume is not deleted when the cluster is decommissioned.
  - `project_id` string: Project ID that will own the volume. When omitted, the caller's default project is used.
  - `instance_cluster_id` string: Cluster ID to place the volume on the same infrastructure as that GPU cluster.

## Response `200`

OK

- GPUClustersSharedVolume
  - `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/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)