# 删除任务

删除一个导出任务。

```text
POST https://moi.matrixorigin.cn/newmoi/export/task/delete
```

## 调用前准备

先[查询任务详情](get-export-task.md)，确认要删除的导出任务。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和导出任务 ID。

下方示例使用：

- `$AI_STUDIO_API_KEY`：实际个人访问令牌，通过 `X-API-Key` Header 传递。
- `$WORKSPACE_ID`：目标工作区 ID，通过 `X-Workspace-ID` Header 传递。
- `$TASK_ID`：要删除的导出任务 ID，填写请求体的 `id` 字段。

当前创建页面在任务运行中时禁用删除。删除任务不会回滚已导出到目标系统的数据。

## 请求体

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `id` | string | 是 | 要删除的导出任务 ID。 |

## 请求示例

```bash
curl -X POST "https://moi.matrixorigin.cn/newmoi/export/task/delete" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "'$TASK_ID'"
  }'
```

## 成功响应

成功时返回 `200`。`data` 为 `null`，表示删除请求已完成；已导出到目标系统的数据不会被回滚。

```json
{
  "code": "OK",
  "msg": "OK",
  "data": null
}
```

响应字段如下。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | `OK` 表示接口调用成功。 |
| `msg` | string | 成功消息，值为 `OK`。 |
| `data` | null | 删除接口不返回任务对象。 |

## 错误响应

业务失败可能以 HTTP `200` 和非 `OK` 的 `code` 返回。

```json
{
  "code": "ErrServer",
  "msg": "服务器内部错误",
  "data": null
}
```

### 常见 HTTP 错误

```{list-table}
:header-rows: 1
:widths: 12 24 36 28

* - HTTP 状态码
  - 错误代码
  - 常见原因
  - 建议操作
* - `400`
  - —
  - 请求体无法解析；该兼容路径返回 `error` 字段而非标准信封。
  - 提交包含非空 `id` 的 JSON 对象。
* - `200`
  - `ErrServer`
  - 任务不存在，或删除处理失败。
  - 先查询任务详情确认 ID；任务运行中时请等待页面允许删除。
* - `403`
  - `ErrForbidden`
  - 当前身份没有删除该任务的权限。
  - 请求授予导出任务删除权限。
* - `503`
  - `ErrCoreAuthorizeUnavailable`
  - 授权服务暂时不可用。
  - 稍后重试。
```

## 后续操作

[查询任务列表](list-export-tasks.md)，确认该任务已不再出现。