触发 API 类型自动化任务¶

接口用途¶

触发 API 类型自动化任务。

请求方式¶

POST

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/dynamic-services/invoke

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

无。

查询参数¶

无。

请求体¶

触发 API 类型自动化任务。payload 对象字段由具体任务的 input_schema / 控制台 API 面板决定。

字段	类型	必填	说明
`service_name`	string	是	任务 API 面板中的服务名
`payload`	object	是	业务输入对象；不可为 null
`version`	string	否	普通 Dynamic Service 可用
`version_number`	integer	否	普通 Dynamic Service 版本号；0 表示最新
`trace`	object	否	普通 Dynamic Service 追踪选项

请求示例¶

curl -X POST 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/dynamic-services/invoke' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"service_name":"<service_name>","payload":{"input":"example"}}'

响应说明¶

命中 Agent Automation 时返回 HTTP 202，data 字段：

字段	类型	说明
`run_id`	string	运行 ID
`status`	string	初始状态，如 `queued`
`result_url`	string	结果查询 URL

HTTP 202 入队不等于业务 payload 已进入智能体上下文。普通 Dynamic Service 可能返回 HTTP 200 与执行结果对象。

使用限制¶

这是 API 类型任务的正确触发入口。
不要用手动运行定时任务接口触发 API 类型任务。