---
title: "Create a Volume"
method: POST
path: "/volumes"
tags: ["Volumes"]
---

# Create a Volume

`POST /volumes`

Creates a new volume.

## Request body

- CreateVolumeRequestContent
  - `catalog_name` string, required — The name of the catalog where the schema and the volume are
  - `schema_name` string, required — The name of the schema where the volume is
  - `name` string, required — The name of the volume
  - `volume_type` 'MANAGED' | 'EXTERNAL', required — The type of the volume
  - `comment` string — The comment attached to the volume
  - `storage_location` string, required — The storage location of the volume

## Response `200`

Successfully created 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)