v2
OpenAPI 3.1.02026-08-07139158192.4 KBVMs
Create a VM
post/v1/orgs/{orgId}/vms/create
Path parameters
orgIdstring required
Request body
allowFallbackboolean
containerCommandstring[]
containerPortinteger
diskSizeGbinteger
envVarsobject
gpuCountinteger
gpuModelIdstring
healthCheckPathstring
healthCheckPortinteger
healthChecksstring[]
imageUrlstring
kernelModulesstring[]
namestring required
nodeIdstring
Place this VM on a specific node. Required to use capacity reserved to your org; omit to use the public pool. There is no fallback: if the node has no room for this GPU count the request is refused rather than placed elsewhere. A node you have no rights on reads as not found.
preferredRegionsstring[]
privilegedboolean
publicboolean
true = open endpoint (no data-plane auth); default false requires an org API key
registryCredentialIdstring
resourceSizestring
sshKeyIdsstring[]
templateIdstring
tierstring
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