---
title: "Submit a queued job"
method: POST
path: "/queue/submit"
tags: ["Queue"]
---

# Submit a queued job

`POST /queue/submit`

Submit a new job to the queue for asynchronous processing. Jobs are
processed in strict priority order (higher priority first, FIFO within
the same priority). Returns a request ID that can be used to poll status
or cancel the job.

## Request body

- QueueJobRequest — Request to submit a job to the queue.
  - `info` object — Arbitrary JSON metadata stored with the job. Returned in status responses, where the model and system may have added or modified keys (e.g. progress).
  - `model` string, required — Required model identifier
  - `payload` object, required — Freeform model input. Passed unchanged to the model. Contents are model-specific.
  - `priority` integer — Job priority. Higher values are processed first (strict priority ordering). Jobs with equal priority are processed in submission order (FIFO).

## Response `200`

Successfully queued request

- QueueJobResponse — Response returned after queueing a job.
  - `requestId` string, required — Unique identifier for the submitted job. Use this to poll status or cancel.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/f26a23fab8e0/schema)