Skip to main content
POST
Create volume
Updated May 8, 2026

Authorizations

X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Headers

X-Project-ID
string<uuid>
required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Body

application/json
name
string
required

Volume display name

Required string length: 1 - 64
Example:

"data-vol-1"

size
integer
required

Volume size in GB

Required range: x >= 1
Example:

100

volume_type
enum<string>
required

Storage class

Available options:
nvme
Example:

"nvme"

filesystem_type
enum<string>

Filesystem to format the volume with on first attach. Linux only — Windows VMs use NTFS automatically. Defaults to ext4.

Available options:
ext4,
xfs,
btrfs
vm_id
string<uuid>

Optional. Attach the volume to this VM at create time. VM must be in the same region.

region
enum<string>

Region. Defaults to the project's default region.

Available options:
us-east

Response

Volume creation accepted

success
boolean
data
object
Last modified on May 8, 2026