---
title: "Submit Instance"
method: POST
path: "/instance"
tags: ["Instances"]
---

# Submit Instance

`POST /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 — unless the
transactional scheduler owns the job (canary/active partition), in which
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.

## Request body

- JobIn
  - `name` string, required
  - `vram_needed_gb` number
  - `priority` integer
  - `tier` string, nullable
  - `num_gpus` integer
  - `host_id` string, nullable
  - `gpu_model` string, nullable
  - `nfs_server` string, nullable
  - `nfs_path` string, nullable
  - `nfs_mount_point` string, nullable
  - `image` string, nullable
  - `interactive` boolean
  - `command` string, nullable
  - `ssh_port` integer
  - `pricing_mode` 'on_demand' | 'spot'
  - `volume_ids` string[], nullable
  - `encrypted_workspace` boolean
  - `init_script` string, nullable
  - `git_repo` string, nullable
  - `auto_launch` string[], nullable
  - `exposed_ports` integer[], nullable
  - `template_image_id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aabiro/apis/xcelsior.md) · [All operations](https://skmtc.net/aabiro/apis/xcelsior/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aabiro/xcelsior/versions/b4f5ef136e6a/schema)