---
title: "Tasks - cancel a task"
method: DELETE
path: "/api/v1/tasks/{taskId}"
tags: ["Tasks"]
---

# Tasks - cancel a task

`DELETE /api/v1/tasks/{taskId}`

Cancels a waiting or queued task. Has no effect on completed/failed tasks.

## Path parameters

- `taskId` string, uuid, required

## Response `200`

Task cancelled

- CancelTaskResponse — Success response for task cancellation
  - `ok` true, required
  - `data` CancelResult, required — Confirmation that a task was successfully cancelled
    - `cancelled` true, required
    - `previousStatus` string, required — Status before cancellation

## Other responses

- `404` — Not found

---

[API](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api.md) · [All operations](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitbybit-dev/bitbybit-cad-cloud-api/revisions/1135d4473bc2/schema)