# 取消指定的文档转换任务 (/zh-CN/api-reference/api-ref/whiteboard/restful/cancel-file-conversion-task)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

取消指定的文档转换任务。

- OpenAPI: /openapi/whiteboard/restful-wb.zh-CN.yaml
- Operation ID: delete-v5-projector-tasks-uuid
- Method: DELETE
- Path: /v5/projector/tasks/{uuid}
- Endpoint: https://api.netless.link/v5/projector/tasks/{uuid}

## Servers

- https://api.netless.link

:::warning[注意]
调用文档转换 API 前，请确保：

- 已在[声网控制台](https://console.shengwang.cn/)开启**文档转图片**或**文档转网页**服务并添加存储配置。详见[开启互动白板配套服务](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/enable-service#开启互动白板配套服务)。

- 已为待转换的文档生成一个公网可访问的 URL 地址。
:::

## Parameters

- `uuid` (path, required, string) - 转换任务的 UUID，即转换任务的唯一标识符，可通过调用[发起文档转换 API](start-file-conversion) 获取。

## Request body

No request body.

## Responses

### 200

若返回的状态码为 `200` 则表示请求成功。响应 Body 中包含本次请求的结果。

若返回的状态码不为 `200` 则表示请求失败。你可以参考[响应状态码](/zh-CN/realtime-media/whiteboard/fastboard-sdk/reference/response-code)了解可能的原因。

- `taskId` (string) - 转换任务的 UUID，即转换任务的唯一标识符。
- `success` (boolean) - 是否成功取消转换任务：

- `true`：取消成功。

- `false`：取消失败。

## Response examples

### 200

```json
{
  "taskId": "转换任务的 UUID，即转换任务的唯一标识符。",
  "success": true
}
```