List volumes

GET

https://api.empiriolabs.ai/v1/gpu/volumes

GET

/v1/gpu/volumes

curl https://api.empiriolabs.ai/v1/gpu/volumes \
     -H "Authorization: Bearer <token>"

200Retrieved

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "kind": "workspace",
      "size_gb": 1,
      "billable_gb": 1.1,
      "bytes_used": 1,
      "status": "creating",
      "attached_instance_id": "string",
      "attachment_count": 1,
      "max_attachments": 1,
      "inode_limit": 1,
      "inodes_used": 1,
      "price_gb_month": 1.1,
      "effective_price_gb_month": 1.1,
      "billed_amount": 1.1,
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "last_synced_at": "2024-01-15T09:30:00Z",
      "arrears_seconds": 1,
      "arrears_since": "2024-01-15T09:30:00Z",
      "error": "string"
    }
  ],
  "pricing": {
    "price_gb_month": 1.1,
    "effective_price_gb_month": 1.1
  },
  "limits": {
    "max_volumes": 1,
    "max_total_size_gb": 1,
    "volume_count": 1,
    "total_size_gb": 1
  },
  "policy": {
    "max_volume_gb": 1,
    "network_max_attachments": 1,
    "network_inodes_per_gb": 1,
    "name_policy": {
      "min_length": 1,
      "max_length": 1,
      "pattern": "string",
      "normalization": "lowercase"
    }
  },
  "capabilities": {
    "object_storage": true,
    "object_gpu_slugs": [
      "string"
    ],
    "object_gpu_boxes": {},
    "object_cluster_ids": [
      "string"
    ],
    "network_storage": true,
    "network_gpu_slugs": [
      "string"
    ],
    "network_gpu_boxes": {},
    "network_cluster_ids": [
      "string"
    ]
  }
}

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Response

Volumes and current storage pricing for your account.

objectenumOptional

Allowed values:

datalist of objectsOptional

pricingobjectOptional

limitsobjectOptional

policyobjectOptional

Current storage creation rules. Existing volumes report their own effective attachment allowance.

capabilitiesobjectOptional