---

name: feishu-perm description: | Feishu permission management for documents and files. Activate when user mentions sharing, permissions, collaborators.

Feishu Permission Tool

Single tool feishu_perm for managing file/document permissions.

Actions

List Collaborators

{ "action": "list", "token": "ABC123", "type": "docx" }

Returns: members with member_type, member_id, perm, name.

Add Collaborator

{ "action": "add", "token": "ABC123", "type": "docx", "member_type": "email", "member_id": "user@example.com", "perm": "edit" }

Remove Collaborator

{ "action": "remove", "token": "ABC123", "type": "docx", "member_type": "email", "member_id": "user@example.com" }

Token Types

| Type | Description | |------|-------------| | doc | Old format document | | docx | New format document | | sheet | Spreadsheet | | bitable | Multi-dimensional table | | folder | Folder | | file | Uploaded file | | wiki | Wiki node | | mindnote | Mind map |

Member Types

| Type | Description | |------|-------------| | email | Email address | | openid | User open_id | | userid | User user_id | | unionid | User union_id | | openchat | Group chat open_id | | opendepartmentid | Department open_id |

Permission Levels

| Perm | Description | |------|-------------| | view | View only | | edit | Can edit | | full_access | Full access (can manage permissions) |

Examples

Share document with email:

{ "action": "add", "token": "doxcnXXX", "type": "docx", "member_type": "email", "member_id": "alice@company.com", "perm": "edit" }

Share folder with group:

{ "action": "add", "token": "fldcnXXX", "type": "folder", "member_type": "openchat", "member_id": "oc_xxx", "perm": "view" }

Configuration

channels:
  feishu:
    tools:
      perm: true  # default: false (disabled)

Note: This tool is disabled by default because permission management is a sensitive operation. Enable explicitly if needed.

Permissions

Required: drive:permission