流程待办回退 - 简道云

流程待办回退调试

1. 简介

1.1 接口简介

该接口用来回退流程待办。

1.2 接口版本

接口版本	更新时间	版本说明
v1	2022.10.28	原始接口
v2	2025.12.17	新增请求参数： back_type

2. 接口调用

该接口用来回退流程待办。

请求地址：https://api.jiandaoyun.com/api/v2/workflow/task/rollback

请求频率：20 次/秒

请求方式：POST

请求参数:

参数	必须	类型	说明
username	是	String	用户名，即成员编号
instance_id	是	String	实例 id，同 data_id
task_id	是	String	任务 id（需要和 username 一一对应）
flow_id	否	Number	回退目标节点：节点配置为回退到指定节点时需要设置 flow_id，根据设置的节点进行回退；节点配置为回退到上一节点时无需设置 flow_id，即使设置了flow_id 也不根据设置的节点回退。
comment	否	String	审批意见
back_type	否	Number	回退人选择节点回退操作配置「回退人选择」时，执行回退需要带该参数： 1：正常流转 2：直达目标节点

请求示例：

{
    "username": "xiaojian",
    "instance_id": "635919d1a2cca9000734511c",
    "task_id": "635919d1a2cca9000734513b",
    "comment": ""回退",
    "back_type": 1
}

响应参数：

参数	类型	说明
status	String	success：表示接口调用成功 failure：表示接口调用失败（失败时会有错误码，错误码描述等信息）
code	Number	错误码
message	String	返回码的描述

响应示例：

成功示例

{
    "status": "success"
}

失败示例

{
    "code": 1010,
    "message": "用户不存在",
    "status": "failure"
}