# 审批任务退回

从当前审批任务，退回到已审批的一个或多个任务节点。退回后，已审批节点重新生成审批任务

## 请求

基本 | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/approval/v4/instances/specified_rollback
HTTP Method | POST
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 访问审批应用(approval:approval:readonly)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 查询参数

名称 | 类型 | 必填 | 描述
---|---|---|---
user_id_type | string | 否 | 用户 ID 类型<br>**示例值**："open_id"<br>**可选值有**：<br>- `open_id`：用户的 open id<br>- `union_id`：用户的 union id<br>- `user_id`：用户的 user id<br>**默认值**：`open_id`<br>**当值为 `user_id`，字段权限要求**：<br>获取用户 user ID(contact:user.employee_id:readonly)

### 请求体
|参数|类型|必须|说明|
|-|-|-|-|
|task_id|string|是|当前审批任务ID，从实例详情中获取task_list中获取，必须是PENDING的任务id|
|user_id|string|是|当前审批任务审批人open_id，从实例详情中获取task_list中获取，必须是PENDING的任务的审批人open_id|
|reason|string|是|退回原因|
|task_def_key_list|list<string>|是|指定退回的任务node_key，从实例详情中获取timeline中获取，必须是PASS的任务node_key|

#### 说明:

-   如果想要退回到发起人，task_def_key_list 中填入 START。

### 请求体示例

```json
{
    "task_id":"7023757604987891234",
    "user_id":"ou_123",
    "reason":"请发起人重新提交，审批人重新审批",
    "task_def_key_list":[
        "START",
        "APPROVAL_141532_3632523"
    ]
}
```

## 响应

### 响应体

|参数|类型|必须|说明|
|-|-|-|-|
|code|int|是|错误码，非0表示失败|
|msg|string|是|返回码的描述|

### 响应体示例

```json
{
    "code": 0,
    "data": {},
    "msg": "success"
}  
```

###