> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maxapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Task

> Cancel a task that is in progress

Cancel a task that is still queued. A task can only be cancelled when its status is `PENDING`. Once a task enters `PROCESSING` or `SUBMITTED`, it can no longer be cancelled.

<ParamField path="taskId" type="string" required>
  The ID of the task to cancel.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.maxapi.io/api/v1/task/9db7d1ed-d1e5-4d11-9f3a-61f653b905ad/cancel \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "msg": "ok"
  }
  ```

  ```json 400 Task being processed theme={null}
  {
    "code": 400,
    "msg": "task is already being processed"
  }
  ```

  ```json 400 Terminal state theme={null}
  {
    "code": 400,
    "msg": "task already in terminal state"
  }
  ```

  ```json 404 theme={null}
  {
    "code": 404,
    "msg": "task not found"
  }
  ```
</ResponseExample>