Sign in
Pods

Create a pod

Compute-fabric pod (BYO container image + SSH keys): a hardened GPU container on a whole native-driver GPU. Admission claims a free device-request GPU unit (see listPodCapacity for what is claimable), snapshots the on-demand rate immutably onto the pod, and drives the guest workflow.

post/v1/pods

Request body

computeClass'on_demand' | 'reserved' | 'interruptible'

purchase option. on_demand (pay per second, no commitment) is the only class sold; reserved is a deprecated alias that is stored as on_demand. interruptible is retired and rejected with 400 COMPUTE_CLASS_RETIRED; it remains listed only until the deprecation window closes.

envVarsobject
gpuCountinteger

how many whole GPUs this pod gets. All of them are claimed on ONE node and passed to the container together; the pod is priced for gpuCount GPUs. Omitted = 1. A request larger than any single node can currently tile is rejected at admission (see freeUnits / maxGpuCount on /v1/pods/capacity).

gpuModelIdstring
httpPortinteger

in-guest HTTP port exposed on the endpoint

imagestring required

tenant container image ref (required)

namestring
publicboolean

true = open endpoint (no data-plane auth); default false requires an org API key

shmSizeGbinteger

size of the pod's private /dev/shm in GiB (docker --shm-size). Optional; omitted lets the platform pick a safe default (a generous share for a pod that owns its whole node, otherwise 2 GiB per GPU). The maximum a create may set is the pod's memory entitlement on its placement node (its GPU-proportional share of node RAM); a larger value is rejected at admission. Raise this when a multi-GPU NCCL / PyTorch DataLoader workload needs more shared memory than the default.

sshKeysstring[]

tenant SSH public keys injected into the guest

Response

Created

capabilityTierstring

compute-fabric capability tier (e.g. "pod"); empty for a plain VM

computeClassstring

compute-fabric purchase option (on_demand; pods created before the rename carry the legacy reserved or interruptible values); empty for a plain VM

createdAtstring
diskSizeGbinteger
endpointUrlstring
gpuCountinteger
gpuModelIdstring
gpuModelNamestring
idstring required
imageUrlstring

tenant container image (pods)

managedBystring

platform owner of this row ("serving" = inference serving replica, read-only on customer surfaces); empty for a customer-launched VM

namestring required
organizationIdstring required
pricePerHourCentsinteger
provisioningStagestring
publicboolean

true = open endpoint (no data-plane auth); false = require an org API key

resourceSizestring
serviceTypestring

managed-service tag; empty for a plain VM

statusstring required
statusReasonstring

human-readable cause for failed/stuck states

tierstring

Changes