# 任务删除接口

根据任务 ID 删除指定的外呼任务。删除后该任务及其关联的拨打配置将被移除，任务列表中不再展示。

<span style="display:inline-block;background:#fae7e9;color:#dc3545;border-radius:6px;padding:2px 8px;font-weight:bold;font-family:monospace;margin-right:8px;">DELETE</span>
`https://dashboard.avavox.com/open/api/task/{taskId}`

**说明**

- 删除操作不可恢复，请谨慎调用。
- 任务处于 **进行中（`running`）** 状态时不允许删除，需先调用[「任务暂停」](https://avavox.com/docs/developer/task/pause.html)接口暂停后再删除。
- 任务下已产生的通话记录不受影响，仍可在「呼叫记录」页面查询。

## 请求头

<span style="font-family:monospace; color:#3451b2; ">Authorization </span> <code style="background:#f0f0f0; ">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

- 填写格式：`Authorization: Bearer <App Key>`
- `<App Key>` 为控制台「App Key 管理」页面生成的 Key。
- 获取方式详见：[《App Key 创建与管理》](https://avavox.com/docs/developer/app-key.html)。


## Path 参数
<span style="font-family:monospace; color:#3451b2; ">taskId </span> <code style="background:#f0f0f0; ">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

需要删除的任务 ID。可在[任务创建](https://avavox.com/docs/developer/task/create.html)接口的响应中获取，或通过[任务查询](https://avavox.com/docs/developer/task/query.html)接口获取。




## 响应数据


<span style="font-family:monospace; color:#3451b2; ">code</span> <code style="background:#f0f0f0; ">int</code>

状态码，200 为成功，其他状态均为失败。

---

<span style="font-family:monospace; color:#3451b2; ">success</span> <code style="background:#f0f0f0;">boolean</code>

是否成功，`true` 表示成功，`false` 表示失败。

---


<span style="font-family:monospace; color:#3451b2; ">message</span> <code style="background:#f0f0f0; ">string</code>

描述信息

---

<span style="font-family:monospace; color:#3451b2; ">data</span> <code style="background:#f0f0f0; ">object</code>

默认为 `null`




## 请求示例

```shell
curl -X DELETE --location 'https://dashboard.avavox.com/open/api/task/123' \
--header 'Authorization: Bearer $Key' \
--header 'Content-Type: application/json' 

```



## 响应示例

```json
{
  "code": 200,
  "message": "操作成功",
  "success": true,
  "data": null
}
```

