Feishu Node

Actions61

Overview

This node is designed to interact with Feishu (Lark) 云文档 (Cloud Document) service, specifically for the operation "更新块的内容" ("Update Block Content"). It allows users to update the content of a specific block within a Feishu document. This is useful in scenarios where automated workflows need to modify structured documents, such as updating meeting notes, collaborative documents, or knowledge bases programmatically.

Practical examples:

Automatically updating a section of a shared project plan after a task is completed.
Modifying documentation blocks based on external triggers (e.g., form submissions).
Keeping certain document sections synchronized with data from other systems.

Properties

Name	Type	Meaning
文档 ID	String	The unique identifier of the document to be updated.
父块 ID	String	The block_id of the parent block. Indicates under which block the update will occur. For root-level updates, use the document_id here.
文档版本	Number	The version of the document to query/update. Use -1 for the latest version.
操作的唯一标识	String	Unique identifier for the operation, used for idempotency. If empty, a new request is initiated; if not empty, ensures the update is idempotent.
用户 ID 类型	Options	The type of user ID to use. Options: Open_id, Union_id, User_id.
请求体JSON	JSON	The request body in JSON format. See Feishu API documentation for structure and required fields.

Output

The node outputs an array of objects in the json field. Each object represents the result of the update operation for an input item. If the operation succeeds, the output contains the response from 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 success output:

[
  {
    "json": {
      // ...fields returned by Feishu API, e.g. updated block info
    }
  }
]

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

[
  {
    "json": {
      "error": "Error message from Feishu API"
    }
  }
]

Dependencies

External Service: Requires access to the Feishu (Lark) Cloud Document API.
Credentials: Needs n8n credentials named feishuCredentialsApi.
Environment: No special environment variables are mentioned, but network access to Feishu's API endpoints is required.

Troubleshooting

Common issues:

Invalid Credentials: If the provided Feishu credentials are incorrect or expired, authentication errors will occur.
Missing Required Fields: Omitting required properties like 文档 ID or 父块 ID will result in validation errors.
Incorrect JSON Structure: If the 请求体JSON property does not match the expected structure, the Feishu API may return a schema or validation error.
Version Conflicts: Using an outdated 文档版本 may cause update conflicts.

Error messages:

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

How to resolve:

Double-check all required fields and their values.
Ensure your Feishu credentials are valid and have sufficient permissions.
Refer to the Feishu API documentation for the correct JSON structure.