v33

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-175267122.5 KB

Create empty volume

Creates a new empty volume of the specified size.

post/volumes

Request body

idstring

Optional custom identifier (auto-generated if not provided)

namestring required

Volume name

size_gbinteger required

Size in gigabytes

tagsTags

User-defined key-value tags.

Example request

{
  "id": "vol-data-1",
  "name": "my-data-volume",
  "size_gb": 10,
  "tags": {
    "team": "backend",
    "env": "staging"
  }
}

Response

Volume created

idstring required

Unique identifier

namestring required

Volume name

size_gbinteger required

Size in gigabytes

tagsTags

User-defined key-value tags.

created_atstring date-time required

Creation timestamp (RFC3339)

Example response

{
  "id": "vol-data-1",
  "name": "my-data-volume",
  "size_gb": 10,
  "tags": {
    "team": "backend",
    "env": "staging"
  },
  "attachments": [
    {
      "instance_id": "inst-abc123",
      "mount_path": "/mnt/data"
    }
  ],
  "created_at": "2025-01-15T09:00:00Z"
}