启用工作流¶
将已停用(disabled)的工作流切换为就绪(ready)状态,并重新激活其已配置的定时调度或数据卷触发入口。已暂停(paused)的工作流需调用恢复工作流连同被工作流暂停的运行一起恢复;调用本接口不会立即新建一次作业运行。
POST https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/{workflow_id}/enable
调用前准备¶
请求参数¶
将 $AI_STUDIO_API_KEY、$WORKSPACE_ID 和 $WORKFLOW_ID 替换为实际值。
curl -X POST "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/$WORKFLOW_ID/enable" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID"
路径参数
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
是 |
要启用的工作流 ID,可从查询工作流列表取得。 |
成功响应¶
返回 HTTP 200 及启用后的工作流详情。若目标工作流已处于 ready 状态,直接返回当前工作流详情。
{
"code": "OK",
"msg": "OK",
"data": {
"workflow": {
"id": "wf-001",
"name": "daily-import",
"description": "导入每日文件",
"source_type": "manual_dsl",
"status": "ready",
"available_actions": [
"update",
"delete",
"run",
"pause",
"list_executions"
],
"execution_mode": "cron",
"cron_expression": "0 2 * * *",
"latest_workflow_version_id": "ver-001",
"execution_summary": {
"total_executions": 8,
"active_executions": 0
},
"trigger_summary": {
"mode": "cron",
"configured": true,
"enabled": true,
"cron_expression": "0 2 * * *"
},
"created_at": "2026-10-14T00:00:00Z",
"updated_at": "2026-10-14T08:30:00Z",
"dsl_yaml": "workflow:\n name: daily-import\n root: main\nroot:\n chain: []\n",
"definition_format": "dsl",
"moi_workflow_def_id": "def-001"
}
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
请求处理成功时为 |
|
string |
请求处理结果说明,成功时为 |
|
object |
本次操作返回的数据。 |
|
object |
启用后的工作流详情对象。 |
|
string |
关联的智能体自动化任务 ID;仅关联时返回。 |
|
string |
关联的编写会话 ID;服务端提供时返回。 |
|
string |
工作流 ID。 |
|
string |
工作流名称。 |
|
string |
工作流说明;设置后返回。 |
|
string |
工作流来源类型,取值为 |
|
string |
启用后的工作流状态,成功启用后为 |
|
array of string |
按当前状态派生的可执行动作提示(取值为 |
|
string |
已配置的运行方式,取值为 |
|
string |
定时调度的 Cron 表达式;仅配置定时调度时返回。 |
|
string |
关联的草稿 ID;服务端提供时返回。 |
|
string |
关联的候选方案 ID;服务端提供时返回。 |
|
string |
最新工作流版本 ID;已生成版本时返回。 |
|
string |
工作流级计算资源 ID;已绑定时返回。 |
|
array of object |
工作流级或节点级计算资源绑定列表;已绑定时返回。 |
|
string |
计算资源 ID。 |
|
string |
计算资源名称;服务端提供时返回。 |
|
boolean |
是否为工作流级绑定。 |
|
array of string |
使用该计算资源的节点名称列表。 |
|
object |
作业运行统计摘要。 |
|
integer |
历史作业总数。 |
|
integer |
当前活动作业数。 |
|
string |
当前活动作业 ID;存在活动作业时返回。 |
|
string |
当前活动作业状态;存在活动作业时返回。 |
|
string |
最近一次作业 ID;存在历史作业时返回。 |
|
string |
最近一次作业状态;存在历史作业时返回。 |
|
string |
最近一次作业时间;存在历史作业时返回。 |
|
object |
触发配置摘要。 |
|
string |
触发运行模式,取值为 |
|
boolean |
是否已完成触发配置。 |
|
boolean |
触发器当前是否处于启用状态。 |
|
integer |
数据卷触发绑定的数据卷 ID;仅数据卷触发时返回。 |
|
string |
定时触发的 Cron 表达式;仅定时触发时返回。 |
|
string |
动态 API 服务名称;仅动态服务模式返回。 |
|
string |
动态服务最新版本的输入 Schema JSON 字符串;存在时返回。 |
|
string |
动态服务最新版本的输出 Schema JSON 字符串;存在时返回。 |
|
string |
创建时间,采用 RFC 3339 格式。 |
|
string |
最近更新时间,采用 RFC 3339 格式。 |
|
string |
工作流目标说明;服务端提供时返回。 |
|
string |
规划模型名称;服务端提供时返回。 |
|
string |
工作流 DSL 文本。 |
|
object |
原生 MOWL 工作流定义对象;按原生定义保存时返回。 |
|
string |
定义格式,取值为 |
|
object |
运行上下文对象;服务端提供时返回。 |
|
object |
运行输入表单定义;已配置时返回,子字段结构与查询工作流详情一致。 |
|
object |
运行输入表单布局;已配置时返回,子字段结构与查询工作流详情一致。 |
|
object |
默认运行参数对象;已配置时返回。 |
|
object |
工作流设计图对象;已配置时返回。 |
|
object |
作业终态通知配置对象;已配置时返回。 |
|
string |
关联的工作流定义 ID;存在时返回。 |
|
object |
动态服务绑定的交互页面资源;仅绑定时返回。 |
|
string |
派生的服务页面资源 URI。 |
|
string |
工作区 HTML 文件 ID。 |
|
string |
资源 MIME 类型,固定为 |
错误响应¶
工作流不存在返回 404(ErrNotFound);工作流由智能体自动化任务托管(source_type 为 agent_automation_task)或运行身份版本失效时返回 409;对处于 paused 状态的工作流调用本接口会因状态前置条件不满足而失败,请改调恢复工作流。
{
"code": "ErrWorkflowUpdateManagedByAutomation",
"msg": "工作流由自动化任务托管,请编辑对应的自动化任务"
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
错误代码,例如 |
|
string |
可读错误信息。 |