latestOpenAPI 3.1.02026-08-23152185247.5 KB

4fa8e9e51d9b

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 effective rate (interruptible prices below the on-demand/reserved rate), and drives the guest workflow.

post/v1/pods

Request body

computeClass'interruptible' | 'reserved'

interruptible = preemptible spot capacity; reserved = held capacity

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

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 compute class (interruptible|reserved); 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