工作流
删除工作流节点
删除已有工作流中的一个节点。适用于 create_process / batch_create_process_nodes 创建后需要撤销某个业务节点的场景。
语义提醒:
• processId 必填,表示目标流程;如果要删除 approval_block / sub_process 内部流程里的节点,传块节点 config.process.processId 返回的内部流程 ID。
• nodeId 必填,只能传真实节点 ID;不支持按 nodeAlias 删除,建议先用 get_workflow_structure 获取节点 ID。
• 开始节点和结束节点不允许删除;服务端会拒绝删除 start/end。
• 删除分支、块节点或带上下游连线的节点时,服务端会复用现有工作流删除逻辑,同时返回 deletedNodes / updatedNodes 供调用方刷新本地结构缓存。
• appId 不从请求体传,统一取当前登录上下文中的应用包 ID。
鉴权方式
AppKey + Sign 是应用密钥鉴权,由管理员创建,用于以应用管理员身份访问应用数据。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
workflow_id | string | 是 | 目标流程 ID,必填。 |
node_id | string | 是 | 要删除的流程节点 ID,必填。不支持 nodeAlias。 |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
HAP-Appkey | string | 是 | HAP应用密钥 |
HAP-Sign | string | 是 | HAP签名 |
响应参数
200调用成功| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
data | object | — |
data.deletedNodes | object[] | 已删除节点列表 |
data.deletedNodes.nodeAlias | string | 节点别名 |
data.deletedNodes.nodeId | string | 节点 ID |
data.deletedNodes.nodeType | string | 节点类型 |
data.deletedNodes.name | string | 节点名称 |
data.deletedNodes.prevNode | object | 前置节点引用 |
data.deletedNodes.parentNode | object | 父级/分支路径节点引用 |
data.deletedNodes.config | object | 节点配置 |
data.updatedNodes | object[] | 被服务端联动更新的节点列表 |
data.updatedNodes.nodeAlias | string | 节点别名 |
data.updatedNodes.nodeId | string | 节点 ID |
data.updatedNodes.nodeType | string | 节点类型 |
data.updatedNodes.name | string | 节点名称 |
data.updatedNodes.prevNode | object | 前置节点引用 |
data.updatedNodes.parentNode | object | 父级/分支路径节点引用 |
data.updatedNodes.config | object | 节点配置 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
curl -X DELETE "https://example.com/v3/app/workflows/workflow_id/nodes/node_id" \ -H "HAP-Appkey: {{HAP-Appkey}}" \ -H "HAP-Sign: {{HAP-Sign}}"{ "success": true, "data": { "deletedNodes": [ { "nodeAlias": "string", "nodeId": "string", "nodeType": "string", "name": "string", "prevNode": {}, "parentNode": {}, "config": {} } ], "updatedNodes": [ { "nodeAlias": "string", "nodeId": "string", "nodeType": "string", "name": "string", "prevNode": {}, "parentNode": {}, "config": {} } ] }, "error_code": 0, "error_msg": "string"}