Skip to main content
POST
/
api
/
v1
/
volumes
Create volume
curl --request POST \
  --url https://api.rafftechnologies.com/api/v1/volumes \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "name": "data-vol-1",
  "size": 100,
  "volume_type": "nvme",
  "filesystem_type": "ext4",
  "vm_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "region": "us-east"
}
'
{
  "success": true,
  "data": {
    "id": 123,
    "name": "data-vol-1",
    "volume_type": "nvme",
    "size": 100,
    "status": "creating",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "product_vm": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "price_per_hour": "<string>",
    "region": "us-east",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt

Use this file to discover all available pages before exploring further.

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