空间管理员设置工作流模板生效版本；只允许已提交版本，每个模板仅一个生效版本，生效前按当前空间成员、数字员工与能力重新校验；已创建工作项使用自身执行快照，不受影响。
接口说明
空间管理员设置工作流模板生效版本；只允许已提交版本，每个模板仅一个生效版本，生效前按当前空间成员、数字员工与能力重新校验；已创建工作项使用自身执行快照，不受影响
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
winnexo:SetWorkflowTemplateEffectiveVersion |
create |
*全部资源
|
无 | 无 |
请求语法
POST /openapi/setWorkflowTemplateEffectiveVersion HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
租户 ID，公共参数；缺省时使用调用方默认租户。 |
10000 |
| collaborationGroupId |
string |
是 |
协作空间 ID。 |
cg_9401 |
| templateId |
string |
是 |
模板 ID。 |
tpl_9401 |
| version |
string |
是 |
本次返回内容所属的版本号。 |
v1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| code |
string |
业务状态码；成功为 200。 |
200 |
| message |
string |
错误描述。 |
请求的资源不存在 |
| requestId |
string |
请求追踪 ID。 |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| templateId |
string |
模板 ID。 |
tpl_9401 |
| name |
string |
步骤名称；草稿可为空，提交时必填。 |
客户投诉处理流程 |
| description |
string |
模板描述。 |
处理客户投诉的标准流程 |
| schemaVersion |
integer |
模板结构版本，当前为 2，与业务版本 vN 独立 |
2 |
| edges |
array<object> |
节点依赖边；每项包含 from/to，引用稳定 stepId |
[] |
|
object |
一条节点依赖边，from 为前置节点 stepId，to 为后置节点 stepId |
{"from":"collect","to":"deliver"} |
|
| layout |
object |
可选画布布局，按 stepId 索引；只影响展示，不决定依赖 |
{"collect":{"x":0,"y":0},"review":{"x":240,"y":0}} |
| steps |
array<object> |
有序步骤。 |
[{"stepId":"collect","sortOrder":1,"name":"收集客户信息"}] |
|
array<object> |
有序步骤。 |
示例流程步骤 |
|
| stepId |
string |
步骤 ID。 |
collect |
| sortOrder |
integer |
步骤顺序。 |
1 |
| name |
string |
步骤名称；草稿可为空，提交时必填。 |
收集客户信息 |
| specification |
string |
从有序片段派生的展示文本；不补固定标题，不独立存储。 |
收集客户信息，交给负责人审核 |
| specificationJson |
array<object> |
有序片段数组，支持 text/mention/skill/app/files/web_search；保留引用身份和顺序。 |
[{"type":"text","text":"收集客户信息"}] |
|
object |
有序片段数组，支持 text/mention/skill/app/files/web_search；保留引用身份和顺序。 |
{"type":"text","text":"收集客户信息"} |
|
| ownerType |
string |
负责人类型：MEMBER 人工 / AGENT 智能体。 |
MEMBER |
| ownerUserId |
integer |
人工负责人用户 ID。 |
1 |
| ownerAgentName |
string |
智能体负责人名称。 |
example |
| reviewerUserIds |
array |
审核人用户 ID 列表。 |
example |
|
integer |
审核人用户 ID 列表。 |
10086 |
|
| modelMode |
string |
模型档位。 |
standard |
| reviewOutput |
boolean |
是否人工审核产出物，默认关闭；仅数字员工可开启，审核待办自动发负责人 |
false |
| createdByUserId |
integer |
创建人用户 ID。 |
10001 |
| gmtCreate |
string |
创建时间(ISO8601)。 |
2026-11-05T08:00:00Z |
| gmtModified |
string |
修改时间(ISO8601)。 |
2026-11-05T08:00:00Z |
| version |
string |
本次返回内容所属的版本号。 |
v1 |
| versionStatus |
string |
版本状态：DRAFT 草稿 / SUBMITTED 已提交。 |
SUBMITTED |
| versionDescription |
string |
该版本的变更说明；为空表示未填写。 |
新增审核步骤 |
| effectiveVersion |
string |
模板当前生效版本号；为空表示仅有草稿、不可用于工作项。 |
v1 |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "请求的资源不存在",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"templateId": "tpl_9401",
"name": "客户投诉处理流程",
"description": "处理客户投诉的标准流程",
"schemaVersion": 2,
"edges": [
{
"from": "collect",
"to": "deliver"
}
],
"layout": {
"collect": {
"x": 0,
"y": 0
},
"review": {
"x": 240,
"y": 0
}
},
"steps": [
{
"stepId": "collect",
"sortOrder": 1,
"name": "收集客户信息",
"specification": "收集客户信息，交给负责人审核",
"specificationJson": [
{
"type": "text",
"text": "收集客户信息"
}
],
"ownerType": "MEMBER",
"ownerUserId": 1,
"ownerAgentName": "example",
"reviewerUserIds": [
10086
],
"modelMode": "standard",
"reviewOutput": false
}
],
"createdByUserId": 10001,
"gmtCreate": "2026-11-05T08:00:00Z",
"gmtModified": "2026-11-05T08:00:00Z",
"version": "v1",
"versionStatus": "SUBMITTED",
"versionDescription": "新增审核步骤",
"effectiveVersion": "v1"
}