---
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

## Changes

- **2026-04-30** `bef883f8a334` — 10 info
  - api operation id `cancelTask` removed and replaced with ``
  - the response property `data` became required for the status `200`
  - the response property `data/cancelled` became required for the status `200`
  - the response property `ok` became required for the status `200`
  - …6 more
- **2026-04-17** `5eb4ed0f33c7` — 7 breaking, 2 warning, 1 info
  - the response property `data` became optional for the status `200`
  - the response property `data/cancelled` became optional for the status `200`
  - the response property `ok` became optional for the status `200`
  - the `cancelled` response property const value `true` was removed for the status `200`
  - …6 more

[Change history](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/changes/api/v1/tasks/:taskId/delete.md)

---

[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)