---
title: "Create volume"
method: POST
path: "/v1/volumes"
tags: ["Volumes"]
---

# Create volume

`POST /v1/volumes`

## Headers

- `user-agent` string, required
- `cf-connecting-ip` string, required

## Request body

- CreateVolumePublicDto
  - `type` 'HDD' | 'NVMe' | 'HDD_Shared' | 'NVMe_Shared' | 'NVMe_Local_Storage' | 'NVMe_Shared_Cluster' | 'NVMe_OS_Cluster', required — Volume type
  - `location_code` string, required — Location code
  - `size` number, required — Volume size in GB
  - `instance_id` string — Instance ID to attach the volume to
  - `instance_ids` string[] — Array of instance IDs to attach the volume to
  - `name` string, required — Volume name
  - `tags` TagDto[] — Key-value tags for the new volume. Maximum 10. Omit `value` for a freeform tag. Keys are lowercased.
    - `key` string, required
    - `value` string — Omit for a freeform tag with no value

## Response `202`

Volume ID

## Other responses

- `403` — One or more of the specified instances is not shut down

---

[API](https://skmtc.net/datacrunch/apis/verda-cloud-public-api.md) · [All operations](https://skmtc.net/datacrunch/apis/verda-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datacrunch/verda-cloud-public-api/revisions/0d66c7340876/schema)