v33

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

List volumes

get/volumes

Query parameters

tagsobject

User-defined key-value tags.

Filter volumes by tag key-value pairs.

{
  "team": "backend",
  "env": "staging"
}

Response

List of volumes

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"
  }
]