---
title: "Cancel Task"
method: GET
path: "/tasks/{task_id}/cancel"
tags: ["Tasks"]
---

# Cancel Task

`GET /tasks/{task_id}/cancel`

Cancel a task that hasn't started processing yet:
- For new tasks: Status will be updated to `Cancelled`
- For updating tasks: Task will revert to the previous state

Requirements:
- Task must have status `Starting`

## Path parameters

- `task_id` string, nullable, required

## Response `200`

Task cancelled successfully

## Other responses

- `400` — Task cannot be cancelled in its current state
- `401` — Unauthorized
- `404` — Task not found
- `500` — Server error

---

[API](https://skmtc.net/chunkr/apis/chunkr-api.md) · [All operations](https://skmtc.net/chunkr/apis/chunkr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chunkr/chunkr-api/versions/cfcf1ff1cbb0/schema)