Instances

Api Submit Instance

Submit a job to the queue or directly assign to a host.

If host_id is provided (marketplace launch), the job is assigned directly to that host and container start is attempted immediately. Otherwise, the job is queued and process_queue runs to find a host.

post/instance

Request body

namestring required
vram_needed_gbnumber
priorityinteger
tierstring nullable
num_gpusinteger
host_idstring nullable
gpu_modelstring nullable
nfs_serverstring nullable
nfs_pathstring nullable
nfs_mount_pointstring nullable
imagestring nullable
interactiveboolean
commandstring nullable
ssh_portinteger
max_bidnumber nullable

Response

Successful Response

{"stackTrail":"paths:/instance:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes