查看工作流模板列表¶

列出当前工作区可见的内置和自定义工作流模板。内置模板按当前语言返回；自定义模板仅返回当前工作区创建的模板。

GET https://moi.matrixorigin.cn/newmoi/workflow-templates

调用前准备¶

准备具有目标工作区访问权限的个人访问令牌和目标工作区 ID。

查询参数¶

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

调用示例

curl "https://moi.matrixorigin.cn/newmoi/workflow-templates?summary=true" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
`summary`	boolean	否	传 `true` 时仅返回用于列表展示的字段；省略时返回完整模板定义。

成功响应¶

成功时返回 200 和模板列表。summary=true 时每项仅返回摘要字段。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": [
    {
      "id": 12,
      "name": "daily-import-template",
      "description": "每日导入工作流模板",
      "is_builtin": false
    }
  ]
}

字段说明

通用字段

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	array of object	模板列表；没有可见模板时为空数组。

模板摘要

下面表格展开响应示例中 data 列表的一项；每一行是一个模板字段。

字段	类型	说明
`id`	integer	模板 ID。
`name`	string	模板名称。
`description`	string	模板说明。
`is_builtin`	boolean	是否为内置模板。

完整模板

省略 summary 时，列表中的每一项还会返回以下字段。

字段	类型	说明
`workspace_id`	string	所属工作区 ID；内置模板为空字符串。
`created_by`	string	创建者标识。
`updated_by`	string	最后更新者标识。
`template_key`	string	内置模板标识；自定义模板为空字符串。
`language`	string	模板语言。
`dsl_yaml`	string	工作流 DSL YAML。
`runtime_fields`	string	运行时字段 JSON 文本。
`created_at`	string	创建时间；服务端未提供时省略。
`updated_at`	string	最后更新时间；服务端未提供时省略。

错误响应¶

响应示例

{
  "code": "ErrWorkspaceIDMissing",
  "msg": "需要工作区 ID",
  "data": null
}

字段说明

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

后续操作¶

使用列表项的 id 查看工作流模板详情。

最后更新于 2026 年 9 月 3 日