---
title: "Clear a model's pending jobs"
method: POST
path: "/v1/queue/clear"
tags: ["Queue"]
---

# Clear a model's pending jobs

`POST /v1/queue/clear`

## Request

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

Cancel all pending jobs for the given model. Running jobs are left untouched. Returns the number of jobs that were canceled.

## Request body

- QueueClearRequest: Request to clear pending jobs for a model.
  - `model` string, required: Model identifier whose pending jobs should be canceled

## Response `200`

Pending jobs canceled

- QueueClearResponse: Count of pending jobs canceled by the clear operation.
  - `canceled_count` integer, required: Number of pending jobs that were canceled

## 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/clear/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)