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

# Submit a queued job

`POST /v1/queue/submit`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/queue/submit`
- Auth: HTTP bearer

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

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/queue/submit/post.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)