Feishu Node

Actions61

Overview

This node is designed to update a record in a Feishu (Lark) Bitable table. It allows users to specify the target table, the record to update, and the new data for that record. This is useful in scenarios where you need to automate updates to structured data stored in Feishu Bitable, such as synchronizing information from other systems, correcting data, or managing workflows that require updating records based on external triggers.

Practical examples:

Automatically updating a project status in a Bitable when a task is completed in another system.
Modifying customer information in a Bitable when changes are detected in your CRM.
Bulk-updating inventory records based on incoming shipment data.

Properties

Name	Type	Meaning
多维表格 Token	String	The unique identifier (token) for the Feishu Bitable App. Required for authentication.
多维表格 ID	String	The unique identifier of the Bitable table where the record resides.
记录 ID	String	The unique identifier of the record to be updated. Obtainable via the record query interface.
用户 ID 类型	Options	The type of user ID used (Open ID, Union ID, User ID).
是否忽略一致性读写检查	Boolean	Whether to ignore consistency read/write checks during the update operation.
请求体JSON	JSON	The request body containing the fields to update. See Feishu API docs for structure.

Output

The node outputs an array of items, each with a json field containing the result of the update operation for each input item. 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 if available).

Example output (success):

[
  {
    "json": {
      // ...fields returned by the Feishu API after updating the record
    }
  }
]

Example output (error, with Continue On Fail):

[
  {
    "json": {
      "error": "Error message here"
    },
    "pairedItem": 0
  }
]

Note: The exact structure of the successful response depends on the Feishu API's response for the update operation.

Dependencies

External Service: Requires access to the Feishu (Lark) Bitable API.
API Credentials: Needs valid Feishu credentials configured in n8n (feishuCredentialsApi).
Environment: No special environment variables required beyond n8n credential setup.

Troubleshooting

Common Issues:
- Invalid Token or Table ID: Ensure that the provided "多维表格 Token" and "多维表格 ID" are correct and have sufficient permissions.
- Record Not Found: If the "记录 ID" does not exist, the API will return an error.
- Malformed Request Body: The "请求体JSON" must match the expected format; refer to the Feishu API documentation.
- Permission Denied: Make sure the authenticated user has permission to update the specified record.
Error Messages:
- "未实现方法: <resource>.<operation>": Indicates the selected resource/operation combination is not implemented in the node.
- "NodeApiError": Usually indicates an error returned by the Feishu API. Check the error field for more details.
- Other errors will be reported with their message in the output if "Continue On Fail" is enabled.