---
title: "Update a Volume"
method: PATCH
path: "/volumes/{name}"
tags: ["Volumes"]
---

# Update a Volume

`PATCH /volumes/{name}`

Updates the specified volume under the specified parent catalog and schema.

Currently only the name or the comment of the volume could be updated.

## Request body

- UpdateVolumeRequestContent
  - `comment` string — The comment attached to the volume
  - `new_name` string — New name for the volume.

## Response `200`

Successfully updated the properties of the volume

- VolumeInfo
  - `catalog_name` string — The name of the catalog where the schema and the volume are
  - `schema_name` string — The name of the schema where the volume is
  - `name` string — The name of the volume
  - `comment` string — The comment attached to the volume
  - `created_at` integer — Time at which this volume was created, in epoch milliseconds.
  - `updated_at` integer — Time at which this volume was last modified, in epoch milliseconds.
  - `volume_id` string — Unique identifier for the volume
  - `volume_type` 'MANAGED' | 'EXTERNAL' — The type of the volume
  - `storage_location` string — The storage location of the volume
  - `full_name` string — Full name of volume, in form of __catalog_name__.__schema_name__.__volume_name__.

---

[API](https://skmtc.net/unitycatalog/apis/unity-catalog-api.md) · [All operations](https://skmtc.net/unitycatalog/apis/unity-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unitycatalog/unity-catalog-api/versions/afb7536b3c70/schema)