Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node integrates with Feishu's task management API to remove members from a specified task. It is useful in scenarios where you need to programmatically update task assignments or permissions by removing one or more users from a task. For example, if a team member leaves a project or their responsibilities change, this node can automate the removal of that user from relevant tasks.

Properties

Name Meaning
任务ID The unique identifier (GUID) of the task from which members will be removed.
用户 ID 类型 The type of user ID used to identify members. Options: Open ID, Union ID, User ID.
成员 A JSON array specifying the members to remove. Each member object includes id, role, and type.

The "成员" property expects a JSON structure similar to:

[
  {
    "id": "string",
    "role": "assignee",
    "type": "user"
  }
]

This corresponds to the members targeted for removal, including their role and type within the task.

Output

The node outputs an array of JSON objects representing the result of the remove members operation for each input item. Each output item contains the response data returned by the Feishu API after attempting to remove the specified members from the task.

If an error occurs and "Continue On Fail" is enabled, the output will include an error object with details about the failure for that particular item.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with Feishu's API.
  • The node depends on Feishu's task management API endpoints to perform the removal of task members.
  • Proper configuration of the Feishu API credentials in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing task ID (任务ID) may cause the API call to fail.
    • Incorrect user ID type or malformed member JSON can lead to errors.
    • Insufficient permissions or expired API tokens will prevent successful member removal.

  • Error messages:

    • "未实现方法: task.task:remove_members" indicates the operation is not implemented or incorrectly referenced.
    • API errors returned from Feishu are captured and can be found in the error output when "Continue On Fail" is enabled.

  • Resolutions:

    • Verify the task GUID and ensure it exists.
    • Confirm the user ID type matches the IDs provided in the members list.
    • Check API credentials and refresh tokens if necessary.
    • Validate the JSON format of the members property against Feishu's API documentation.

Links and References

Discussion