删除工作流版本

永久删除指定工作流中处于 draft(草稿)状态的版本记录。已发布(published)或已废弃(deprecated)的版本不能删除;已发布版本如需停用,请调用废弃工作流版本。

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

调用前准备

  1. 准备具有工作流版本删除权限的个人访问令牌和目标工作区 ID。

  2. 先调用查询工作流版本列表或查询工作流版本详情确认待删除版本的 Status 为 draft,且目标工作流不由智能体自动化任务托管。

请求参数

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

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"

路径参数

参数

类型

是否必填

说明

workflow_id

string

是

目标工作流 ID,可从查询工作流列表取得。

version_id

string

是

待删除的草稿版本 ID(Status 必须为 draft),可从查询工作流版本列表取得。

成功响应

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

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

字段

类型

说明

code

string

请求处理成功时为 OK。

msg

string

请求处理结果说明,成功时为 OK。

data

object

删除操作结果对象。

data.deleted

boolean

版本记录是否已删除,成功时为 true。

错误响应

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

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

字段

类型

说明

code

string

错误代码,例如 ErrWorkspaceRequired、ErrForbidden、ErrNotFound、ErrWorkflowUpdateManagedByAutomation 或 ErrServer。

msg

string

可读错误信息。

最后更新于