Feishu Node

Actions61

Overview

This n8n custom node enables batch deletion of records from a Feishu (Lark) 多维表格 (Bitable) table. It is designed for scenarios where you need to remove multiple records at once from a specified Bitable using the Feishu Open Platform API. This is particularly useful for automating data cleanup, synchronizing datasets, or managing large tables efficiently.

Practical examples:

Automatically deleting outdated or invalid entries from a Feishu Bitable.
Integrating with other systems to keep your Feishu tables in sync by removing records that no longer exist elsewhere.
Bulk removal of test data after QA processes.

Properties

Name	Type	Meaning
多维表格 Token	String	The unique identifier (token) for the Feishu Bitable App. Required for authentication.
多维表格 ID	String	The unique identifier for the specific Bitable table from which records will be deleted.
请求体JSON	JSON	The request body specifying which records to delete. Should follow Feishu API format.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output object typically contains the result of the batch delete operation as returned by the Feishu API. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message (and possibly additional error details).

Example output (success):

[
  {
    "data": {
      // ...fields returned by Feishu API on successful deletion
    }
  }
]

Example output (error, with Continue On Fail):

[
  {
    "error": "Error message here"
  }
]

Note: The exact structure of the success response depends on the Feishu API's response for batch deletion.

Dependencies

Feishu (Lark) Open Platform: Requires access to the Feishu Bitable API.
API Credentials: You must configure feishuCredentialsApi in n8n with valid credentials for your Feishu app.
Environment: No special environment variables are required beyond standard n8n credential setup.

Troubleshooting

Missing or Invalid Token: If the 多维表格 Token is missing or incorrect, the node will fail with an authentication error. Ensure your credentials are correct and have sufficient permissions.
Invalid Table ID: Providing an incorrect 多维表格 ID will result in a "not found" or similar error from the Feishu API.
Malformed 请求体JSON: If the JSON body does not match the expected format (e.g., missing the records array), the API call will fail. Refer to the Feishu API documentation for the correct structure.
API Rate Limits: Excessive requests may trigger rate limiting by Feishu. Monitor and adjust your workflow accordingly.
Error Handling: If "Continue On Fail" is enabled, errors for individual items will be included in the output; otherwise, the node will stop execution on the first error.