Feishu Node

Overview

This node is designed to interact with a knowledge base system, specifically to delete members from a knowledge space. It allows users to remove collaborators such as users, groups, or departments from a specified knowledge space by identifying them through various ID types and roles.

Common scenarios where this node would be beneficial include:

• Managing access control in a collaborative knowledge base by removing outdated or unauthorized members.
• Automating the cleanup of member lists when team structures change.
• Integrating with organizational workflows to maintain up-to-date membership in knowledge spaces.

For example, an organization might use this node to automatically remove a user who has left the company from all relevant knowledge spaces, ensuring sensitive information remains secure.

Properties

Name	Meaning
知识空间ID	The unique identifier of the knowledge space from which a member will be removed.
成员ID	The identifier of the member or administrator to be deleted. The type depends on the member type selected.
成员类型	The type of identifier used for the member. Options: 群ID (Group Chat ID), 用户ID (User ID), 邮箱 (Email), 部门ID (Department ID), Open ID, Union ID.
角色	The role of the member within the knowledge space. Options: 管理员 (Administrator), 成员 (Member).
协作者类型	The collaborator type in the knowledge base. Options: 用户 (User), 群组 (Group), 组织架构 (Department). Note: This option is currently not supported.

Output

The node outputs JSON data representing the result of the deletion operation for each input item. Each output item corresponds to an input and contains either the success response or error details if the operation failed.

If the node encounters an error during the deletion process and "Continue On Fail" is enabled, it outputs an error object with the error message for that specific item.

No binary data output is produced by this node.

Dependencies

• Requires an API key credential for authenticating with the knowledge base service.
• The node depends on the external knowledge base API to perform member deletion operations.
• Proper configuration of the API credentials in n8n is necessary for successful execution.

Troubleshooting

• Common Issues:

  • Invalid or missing knowledge space ID or member ID can cause the operation to fail.
  • Incorrect member type selection may lead to the API not finding the member to delete.
  • Insufficient permissions (e.g., trying to delete an administrator without proper rights) can result in authorization errors.

• Error Messages:

  • Errors returned from the API are captured and can be output per item if "Continue On Fail" is enabled.
  • Typical error messages might include "Member not found," "Unauthorized," or "Invalid parameters."

• Resolution Tips:

  • Verify that the knowledge space ID and member ID are correct and correspond to existing entities.
  • Ensure the member type matches the format of the member ID provided.
  • Confirm that the API credentials have sufficient permissions to perform deletions.
  • Use the node's logging/debugging features to inspect detailed error messages.

Links and References

• Refer to the official documentation of the knowledge base API for details on member management and deletion endpoints.
• Consult n8n documentation on how to configure API credentials and handle errors in workflow nodes.