Sign in

v2

latestOpenAPI 3.1.02026-08-07139158192.4 KB
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
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)

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