Queue

Get job status

Changed on

Poll the current status of a previously submitted job. Provide the request_id and model as query parameters.

get/v1/queue/status

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/queue/status
  • Auth
    HTTP bearer

Query parameters

request_idstring required

Request ID returned from the submit endpoint

modelstring required

Model name the job was submitted to

Response

Status information

claimed_atstring date-time

Timestamp when a worker claimed the job

created_atstring date-time

Timestamp when the job was created

done_atstring date-time

Timestamp when the job completed (done or failed)

infoobject

Job metadata. Contains keys from the submit request, plus any modifications from the model or system (e.g. progress, retry history).

inputsobject

Freeform model input, as submitted

modelstring required

Model identifier the job was submitted to

outputsobject

Freeform model output, populated when the job reaches done status. Contents are model-specific.

priorityinteger

Job priority. Higher values are processed first.

request_idstring required

The request ID that was returned from the submit endpoint

retriesinteger

Number of times this job has been retried. Workers set a claim timeout and must send periodic status updates to keep the job alive. If no update is received within the timeout, the job is returned to the queue and retried. After 3 retries the job is permanently failed. Jobs explicitly failed by the model are not retried.

status'pending' | 'running' | 'done' | 'failed' | 'canceled' required

Current job status. Transitions: pending → running → done/failed. A pending job may also be canceled.

warningsstring[]

Non-fatal messages about the request (e.g. deprecation notices)

Changes