Feishu Approval

Create and query approval instances via the Approval API.

Base URL:

https://open.feishu.cn/open-apis/approval/v4

Approval Instances

API	Endpoint	Method	Request Body Example	Description
Create Instance	`/instances`	POST	`{"approval_code":"7C46...","user_id":"ou_xxx","form":"{\"widget1\":\"value1\"}"}`	Initiate approval
Query Instance	`/instances/{instance_id}`	GET	-	Get approval status
Approval Action	`/instances/{instance_id}/approve`	POST	`{"comment":"Approved","task_id":"xxx"}`	Approve/Reject approval
Cancel Approval	`/instances/{instance_id}/cancel`	POST	`{"user_id":"ou_xxx"}`	Applicant cancels approval
Transfer Approval	`/instances/{instance_code}/transfer`	POST	`{"user_id":"ou_xxx","transfer_user_id":"ou_yyy","comment":"Transfer"}`	Transfer to another person
Urge Approval	`/instances/{instance_id}/urge`	POST	-	Send reminder for approval
Get Instance List	`/instances`	GET	Query Parameters: `page_size=50&page_token=xxx&user_id=ou_xxx`	Supports filter parameters (pagination)
Query Instance Details	`/instances/detail`	POST	`{"instance_code":"xxx"}`	Query complete details

Create Instance:

json

{
  "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
  "user_id": "ou_xxx",
  "form": "{\"widget1\":\"Request 3 days of leave\"}"
}

Approval Tasks

API	Endpoint	Method	Request Body Example	Description
Get Task List	`/tasks`	GET	-	Query pending tasks
Get Task Details	`/tasks/{task_id}`	GET	-	Query task details
Approve Task	`/tasks/{task_id}/approve`	POST	`{"comment":"Approved"}`	Process approval task
Transfer Task	`/tasks/{task_id}/transfer`	POST	`{"transfer_user_id":"ou_xxx"}`	Transfer task

Approval Definitions

API	Endpoint	Method	Request Body Example	Description
Get Definition List	`/approvals`	GET	-	Query all approval templates
Get Definition Details	`/approvals/{approval_code}`	GET	-	Query template details
Get Definition Form	`/approvals/{approval_code}/forms`	GET	-	Query form field definitions

Approval CC

API	Endpoint	Method	Request Body Example	Description
Get CC List	`/cc`	GET	-	Query approvals copied to me
Mark CC as Read	`/cc/{instance_id}/read`	POST	-	Mark CC as read

Approval Comments

API	Endpoint	Method	Request Body Example	Description
Add Comment	`/instances/{instance_id}/comments`	POST	`{"content":"Comment content","user_id":"ou_xxx"}`	Add approval comment
Get Comments	`/instances/{instance_id}/comments`	GET	-	Query comment list

Common Parameter Explanations

user_id_type: User ID type

```
open_id
```
(default)
```
user_id
```
```
union_id
```

Pagination Parameters:

```
page_size
```
: Number of items per page (default 20, max 100)
```
page_token
```
: Pagination token

Instance Status:

```
PENDING
```
: In approval
```
APPROVED
```
: Approved
```
REJECTED
```
: Rejected
```
CANCELED
```
: Canceled
```
DELETED
```
: Deleted

Test Examples

Get Approval Definition List:

bash

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/approvals?page_size=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

Create Approval Instance:

bash

curl -X POST "https://open.feishu.cn/open-apis/approval/v4/instances" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
    "user_id": "ou_xxx",
    "form": "{\"widget1\":\"Request 3 days of leave\"}"
  }'

Query Instance List:

bash

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/instances?page_size=20&user_id=ou_xxx" \
  -H "Authorization: Bearer YOUR_TOKEN"

Best Practices

Get approval definitions first (confirm form fields)
Form must be stringified JSON
Approval actions require approver permissions
Pagination query: Use page_token for large datasets
user_id is required: Specify user_id when creating instances and querying lists

feishu-approval

NPX Install

Tags

SKILL.md Content (Chinese)

Feishu Approval

Approval Instances

Approval Tasks

Approval Definitions

Approval CC

Approval Comments

Common Parameter Explanations

Test Examples

Best Practices