Create a volume | EmpirioLabs AI Docs

{
  "volume": {
    "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"
  }
}

Create an empty volume. Pass kind=object for an S3-compatible bucket mounted at /mnt/<name>, or kind=network for a /workspace shared by compatible GPU instances and cluster nodes. Workspace and network volumes are billed by configured size; object buckets bill at least the selected size, with stored usage above it rounded up to whole GB. Storage is prorated per second using a 730-hour month.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequiredformat: "^[a-z0-9][a-z0-9\-]*[a-z0-9]$"2-32 characters

Uppercase letters are converted to lowercase before validation.

size_gbintegerRequired1-4000

Volume size in GB, from 1 to 4,000.

kindenumOptionalDefaults to workspace

workspace saves /workspace on stop and restores it on the next attach. object is an S3-compatible bucket mounted at /mnt/<name> and read in place. network shares /workspace across compatible instances and cluster nodes, with the same returned per-GB rate.

Allowed values:

Response

Volume created.

volumeobjectOptional

Errors

400

Bad Request Error

402

Payment Required Error

409

Conflict Error

503

Service Unavailable Error