Instances

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 for its worker to start (SSH only without an agent). When the transactional scheduler owns the job (canary/active partition), case the pin is recorded and placement/start stay with the claim→reserve path. Otherwise the job is queued and process_queue runs to find a host.

post/instance

Request

  • Base URL
    https://xcelsior.ca
  • URL
    https://xcelsior.ca/instance
  • Auth
    HTTP bearer

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
pricing_mode'on_demand' | 'spot'
volume_idsstring[] nullable
encrypted_workspaceboolean
exclusive_gpuboolean
init_scriptstring nullable
git_repostring nullable
auto_launchstring[] nullable
exposed_portsinteger[] nullable
template_image_idstring nullable

Response

Successful Response

unknown required

Changes