查询工作流作业详情

读取指定工作流作业的当前执行信息。HTTP 成功只表示读取成功，应根据响应中的执行状态判断作业结果。

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

调用前准备

先查询工作流作业列表取得工作流 ID 和执行 ID。准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

下方示例使用：

• $AI_STUDIO_API_KEY：实际个人访问令牌，通过 X-API-Key Header 传递。

• $WORKSPACE_ID：目标工作区 ID，通过 X-Workspace-ID Header 传递。

• $WORKFLOW_ID：作业所属的工作流 ID。

• $EXECUTION_ID：要查询的作业执行 ID。

路径参数

参数	类型	说明
workflow_id	string	工作流 ID。
execution_id	string	作业 ID。

请求示例

curl "https://moi.matrixorigin.cn/newmoi/workflow/v2/workflow-apps/$WORKFLOW_ID/executions/$EXECUTION_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

成功响应

成功时返回 200。根据 data.execution.status 判断作业的当前或最终状态。

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "execution": {
      "execution_id": "exec-001",
      "workflow_id": "wf-001",
      "status": "running",
      "available_actions": ["pause", "cancel"],
      "execution_mode": "one_shot",
      "input_payload": {
        "source": "file-001"
      },
      "vars_payload": {},
      "moi_task_id": "task-001",
      "moi_case_id": "case-001",
      "started_at": "2026-08-18T10:00:00Z",
      "created_at": "2026-08-18T10:00:00Z"
    }
  }
}

响应字段如下。

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
data.execution.execution_id	string	执行 ID。
data.execution.workflow_id	string	工作流 ID。
data.execution.status	string	当前执行状态。
data.execution.available_actions	string（字符串数组）	当前可执行的操作。
data.execution.execution_mode	string	执行模式。
data.execution.cron_expression	string	Cron 表达式；未配置时可能省略。
data.execution.input_payload	object	服务端展开后的运行输入。
data.execution.vars_payload	object	服务端展开后的运行变量。
data.execution.moi_task_id	string	服务端任务标识；有值时返回。
data.execution.moi_case_id	string	服务端案例标识；有值时返回。
data.execution.moi_workflow_def_id	string	工作流定义标识；有值时返回。
data.execution.moi_workflow_version_id	string	工作流版本标识；有值时返回。
data.execution.pause_scope	string	暂停范围；有值时返回。
data.execution.error	string	错误信息；有值时返回。
data.execution.started_at	string	开始时间；未产生时可能省略。
data.execution.ended_at	string	结束时间；未产生时可能省略。
data.execution.created_at	string	创建时间；未产生时可能省略。
data.execution.updated_at	string	最后更新时间；未产生时可能省略。

错误响应

{
  "code": "ErrNotFound",
  "msg": "资源不存在",
  "data": null
}

常见 HTTP 错误

HTTP 状态码	错误代码	常见原因	建议操作
400	ErrParamInvalid	execution_id 为空或无效。	使用作业列表或创建响应中的执行 ID。
401	ErrUnauthorized	缺少或无效的访问凭据。	检查 API Key 和工作区 Header。
403	ErrForbidden	当前身份没有工作流读取权限。	请求授予 workflow.read 权限。
404	ErrNotFound	作业不存在，或不属于路径中的工作流。	核对工作流 ID、执行 ID 和工作区。
503	ErrServiceUnavailable	依赖服务暂不可用。	稍后重试。
500	ErrServer	服务端未能读取作业。	稍后重试。

后续操作

作业仍在进行时可刷新工作流作业状态。需要产出时查询工作流作业结果。

最后更新于 2026 年 8 月 22 日