Feishu Perm

What it does

This skill, Feishu Perm, automates permission management within Feishu (Lark's messaging and collaboration platform). It allows an AI agent to list collaborators on files/documents, add new collaborators with specific permissions, and remove existing collaborators. The tool supports various file types including documents, spreadsheets, tables, folders, and more, streamlining user access control and enhancing security. It is disabled by default due to the sensitivity of permission management operations.

When to use it

• Granting edit access to a document for a specific team member.
• Removing read-only access from a folder after a project phase concludes.
• Listing all collaborators on a shared spreadsheet to audit permissions.
• Adding a group chat as a viewer to a file.
• Managing permissions on various Feishu resources like documents, spreadsheets, and folders.

Key capabilities

• List Collaborators: Retrieves a list of users with access to a specified document or folder, including their member type, ID, permission level, and name.
• Add Collaborator: Adds a new user as a collaborator on a file/document, specifying the user's identifier (email, open_id, etc.) and desired permission level (view, edit, full access).
• Remove Collaborator: Removes an existing user from a file/document’s collaborators.
• Supports various document types: doc, docx, sheet, bitable, folder, file, wiki, mindnote.
• Handles different member identifiers: email, openid, userid, unionid, openchat, opendepartmentid.
• Offers permission levels: view, edit, full_access.

Example prompts

• "List the collaborators on document with token ABC123."
• "Add user [email protected] to the document with token doxcnXXX and give them edit permissions."
• "Remove user [email protected] from the folder with token fldcnXXX."

Tips & gotchas

• The skill is disabled by default; you must explicitly enable it in your configuration (perm: true).
• Permission management is a sensitive operation, so ensure appropriate safeguards are in place before enabling and using this tool.
• You need the correct "token" for each file/document to manage permissions.