重试工作流作业¶

为一个工作流作业创建重试执行。请求成功不表示重试已经完成；请继续查看新作业的状态。

POST https://moi.matrixorigin.cn/newmoi/workflow/v2/workflow-apps/{workflow_id}/executions/{execution_id}/retry

调用前准备¶

先查看工作流作业详情，确认该作业当前允许重试。准备具有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求体¶

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

输入示例

curl -X POST "https://moi.matrixorigin.cn/newmoi/workflow/v2/workflow-apps/$WORKFLOW_ID/executions/$EXECUTION_ID/retry" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "trigger_now": true
  }'

参数说明

参数	类型	是否必填	说明
`workflow_id`	string	是	工作流 ID，位于请求路径中。
`execution_id`	string	是	要重试的作业 ID，位于请求路径中。
`values`	object	否	重试时使用的运行时输入值。
`trigger_now`	boolean	否	是否立即触发重试。

成功响应¶

成功时返回 200，并返回新作业的执行信息。记录新作业 ID，用于查看重试进度。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "workflow_run": {
      "execution_id": "exec-002",
      "workflow_id": "wf-001",
      "status": "submitted",
      "execution_mode": "one_shot"
    }
  }
}

字段说明

通用字段

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	object	响应数据。
`workflow_run`	object	新作业的执行信息。

作业信息

下面表格展开响应示例中 data 下的 workflow_run 对象；每一行是该对象的一个字段。

字段	类型	说明
`execution_id`	string	新作业 ID。
`workflow_id`	string	工作流 ID。
`status`	string	新作业当前状态。
`execution_mode`	string	工作流运行方式。
`available_actions`	array of string	当前可执行的操作；有值时返回。
`error`	string	作业错误信息；有错误时返回。

错误响应¶

响应示例

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	可读错误信息。
`data`	null	错误响应中为 `null`。

后续操作¶

使用响应中的新作业 ID 查看工作流作业详情。

最后更新于 2026 年 9 月 3 日