# 删除工作流版本

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

永久删除指定工作流中处于 `draft`（草稿）状态的版本记录。已发布（`published`）或已废弃（`deprecated`）的版本不能删除；已发布版本如需停用，请调用[废弃工作流版本](deprecate-workflow-version.md)。

```text
DELETE https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/{workflow_id}/versions/{version_id}
```

## 调用前准备

1. 准备具有工作流版本删除权限的[个人访问令牌](../../../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)和[目标工作区 ID](../../../../../../guides/ai-studio/resource-center/workspace.md#复制工作区-id)。
2. 先调用[查询工作流版本列表](list-workflow-versions.md)或[查询工作流版本详情](get-workflow-version.md)确认待删除版本的 `Status` 为 `draft`，且目标工作流不由智能体自动化任务托管。

## 请求参数

将 `$AI_STUDIO_API_KEY`、`$WORKSPACE_ID`、`$WORKFLOW_ID` 和 `$VERSION_ID` 替换为实际值。

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X DELETE "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/$WORKFLOW_ID/versions/$VERSION_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"
```

:::::
:::::{tab-item} 参数说明

### 路径参数

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `workflow_id` | string | 是 | 目标工作流 ID，可从[查询工作流列表](../list-workflows.md)取得。 |
| `version_id` | string | 是 | 待删除的草稿版本 ID（`Status` 必须为 `draft`），可从[查询工作流版本列表](list-workflow-versions.md)取得。 |

:::::
::::::
:::::::

## 成功响应

返回 HTTP `200` 并确认草稿版本记录已删除。

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "deleted": true
  }
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 请求处理成功时为 `OK`。 |
| `msg` | string | 请求处理结果说明，成功时为 `OK`。 |
| `data` | object | 删除操作结果对象。 |
| `data.deleted` | boolean | 版本记录是否已删除，成功时为 `true`。 |

:::::
::::::
:::::::

## 错误响应

工作流不存在、版本不存在（含已删除后重复调用），或版本不属于目标工作流定义时返回 `404`（`ErrNotFound`）；工作流由智能体自动化任务托管时返回 `409`（`ErrWorkflowUpdateManagedByAutomation`）；对 `published` 或 `deprecated` 状态的版本调用本接口会因状态前置条件不满足而失败。

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "ErrNotFound",
  "msg": "Not Found"
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 错误代码，例如 `ErrWorkspaceRequired`、`ErrForbidden`、`ErrNotFound`、`ErrWorkflowUpdateManagedByAutomation` 或 `ErrServer`。 |
| `msg` | string | 可读错误信息。 |

:::::
::::::
:::::::
