# Human Task - Cancelled

Cancel a human task (including approval tasks, fill in tasks)

## Request

Facts |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/apaas/v1/approval_instances/:approval_instance_id/cancel
HTTP Method | POST
Rate Limit | [100 per minute](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
Supported app types | Custom App
Required scopes<br>**To use this API, you must have at least 1 of the listed scopes.** | app_engine:approval:write

### Request header

Parameter | Type | Required | Description
---|---|---|---
Authorization | string | Yes | `tenant_access_token`<br>**Value format**: "Bearer `access_token`"<br>**Example value**: "Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[How to choose and get access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | Yes | **Fixed value**: "application/json; charset=utf-8"

### Path parameters

Parameter | Type | Description
---|---|---
approval_instance_id | string | Approval instance, which can be obtained by [Query Human Task] (/uAjLw4CM/ukTMukTMukTM/apaas-v1/user_task/query)<br>**Example value**: "1788173550023689"

### Request body

Parameter | Type | Required | Description
---|---|---|---
user_id | string | Yes | The kunlunUserID of the operating user can be obtained through the Apaas user management page<br>**Example value**: "1234"
opinion | string | Yes | Reason for revocation<br>**Example value**: "revoked"

### Request body example
```json
{
    "user_id": "1234",
    "opinion": "revoked"
}
```

## Response

### Response body

Parameter | Type | Description
---|---|---
code | int | Error codes, fail if not zero
msg | string | Error descriptions
data | \- | \-

### Response body example
```json
{
    "code": 0,
    "msg": "Success",
    "data": {}
}
```

### Error code

HTTP status code | Error code | Description | Troubleshooting suggestions
---|---|---|---
400 | 2320001 | Param is invalid | Please check the input parameters