Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This node is designed to interact with the Feishu (Lark) cloud document service, specifically to delete a block (content section) within a document. It is useful in automated workflows where you need to programmatically remove sections from documents, such as cleaning up templates, removing outdated content, or managing collaborative editing processes.

Practical examples:

  • Automatically deleting a specific section from a meeting notes document after processing its contents.
  • Removing placeholder blocks from a template document once real data has been inserted elsewhere.
  • Cleaning up obsolete or sensitive information from shared documents as part of a compliance workflow.

Properties

Name Type Meaning
文档 ID String The unique identifier of the document. Required to specify which document to operate on.
父块 ID String The ID of the parent block. This identifies the block to be deleted within the document.
文档版本 Number The version of the document to query. -1 means the latest version will be used.
操作的唯一标识 String A unique identifier for the operation, corresponding to the API's client_token. Used for idempotency; leave empty for a new request.

Output

The node outputs a JSON object for each processed item. If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message (and possibly additional error details if available). Otherwise, the output will reflect the response from the Feishu API for the block deletion operation.

Example success output:

{
  // ...fields returned by the Feishu API upon successful block deletion
}

Example error output (when Continue On Fail is enabled):

{
  "error": "Error message here"
}

Dependencies

  • Feishu API: Requires access to the Feishu (Lark) cloud document API.
  • Credentials: You must configure feishuCredentialsApi in n8n for authentication.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common issues:

  • Invalid Document or Block ID: If the provided document or block ID does not exist, the API will return an error.
  • Permission Denied: The credentials used may lack permission to modify the specified document.
  • Idempotency Issues: Reusing the same "操作的唯一标识" (client token) unintentionally can cause unexpected results.

Common error messages:

  • "未实现方法: doc.doc:block:delete": Indicates that the requested resource-operation combination is not implemented in the node.
  • Errors from the Feishu API (e.g., invalid IDs, permission errors) will appear in the error field of the output when "Continue On Fail" is enabled.

How to resolve:

  • Double-check all input property values, especially IDs.
  • Ensure your Feishu credentials have sufficient permissions.
  • Use a unique client token for each distinct operation unless intentionally repeating an action for idempotency.

Links and References

Discussion