---
title: "Creates a Volume with metadata that is provided from the personality"
method: POST
path: "/storage/volumes"
tags: ["storage"]
---

# Creates a Volume with metadata that is provided from the personality

`POST /storage/volumes`

Create a volume

## Request body

- VolumeRequest
  - `Name` string, required
  - `Driver` string, required
  - `DriverArgs` object
  - `Store` string, required
  - `Capacity` integer, required
  - `Metadata` object

## Response `201`

Created

- VolumeResponse
  - `Name` string, required
  - `Label` string, required — this is the label used to mount the block device
  - `Driver` string, required
  - `Store` string, required
  - `Metadata` object

## Other responses

- `404` — VolumeStore Does not Exist
- `409` — Volume already exists by that ID
- `500` — Error
- `default` — error

## Changes

- **2018-06-14** `d95851b27556` — 1 info
  - added the new optional `header` request parameter `Op-ID` to all path's operations
- **2017-01-26** `f33199db1e27` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2016-09-22** `cd3b04ac340a` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

[Change history](https://skmtc.dev/vmware/apis/port-layer-api/changes/storage/volumes/post.md)

---

[API](https://skmtc.dev/vmware/apis/port-layer-api.md) · [All operations](https://skmtc.dev/vmware/apis/port-layer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vmware/port-layer-api/revisions/5fff0b8814c7/schema)