---
title: "Update a volume"
method: PATCH
path: "/deployments/storage/volumes/{id}"
tags: ["Volumes"]
---

# Update a volume

`PATCH /deployments/storage/volumes/{id}`

Update an existing volume's configuration or contents

## Path parameters

- `id` string, required — Volume ID or name.

## Request body

- UpdateVolumeRequest
  - `content` VolumeContentRequest — Content specifies the new content to preload to this 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)
  - `name` string — Name is the new unique identifier for the volume within the project
  - `type` 'readOnly'

## Response `200`

Volume updated successfully

- VolumeResponseItem
  - `content` VolumeContent
    - `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
    - `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")
  - `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
- `404` — Volume not found
- `500` — Internal server error

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/468edbdc879c/schema)