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

# Cancel a queued job

`POST /queue/cancel`

Cancel a pending job. Only jobs in pending status can be canceled.
Running jobs cannot be stopped. Returns the job status after the
attempt. If the job is not pending, returns 409 with the current status
unchanged.

## Request body

- QueueCancelRequest — Request to cancel a queued job.
  - `model` string, required — Model identifier the job was submitted to
  - `request_id` string, required — The request ID returned from the submit endpoint

## Response `200`

Successfully canceled

- QueueCancelResponse — Status returned after a cancel attempt.
  - `status` 'canceled' | 'running' | 'done' | 'failed', required — Job status after the cancel attempt. Only pending jobs can be canceled. If the job is already running, done, or failed, the status is returned unchanged.

## Other responses

- `400` — Invalid request
- `404` — Request not found
- `409` — Job could not be canceled (already completed/failed)
- `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)