Feishu Node

Actions61

Overview

The "批量更新记录" (Batch Update Records) operation for the 多维表格 (Bitable) resource in this custom n8n node allows users to update multiple records in a Feishu Bitable table in a single request. This is particularly useful for synchronizing data, performing mass updates, or integrating with other systems where bulk modifications are required. For example, you might use this node to update the status of several tasks at once, correct data across many rows, or apply changes from another system into your Feishu Bitable.

Properties

Name	Type	Meaning
多维表格 Token	String	The unique identifier (token) for the Bitable App. Required to authenticate and specify which app's table will be updated.
多维表格 ID	String	The unique identifier for the specific Bitable table whose records are to be updated.
用户 ID 类型	Options	The type of user ID used in the operation. Options include Open ID, Union ID, and User ID. Determines how user identities are referenced in the request.
操作的唯一标识	String	A unique identifier for the operation (client_token). Used for idempotency; if provided, ensures repeated requests do not result in duplicate updates.
是否忽略一致性读写检查	Boolean	Whether to ignore consistency read/write checks. If true, the operation may skip certain consistency validations for performance or compatibility reasons.
请求体JSON	JSON	The request body containing the records to update. Must follow the structure defined in the Feishu API documentation.

Output

The node outputs an array of JSON objects, each corresponding to the result of updating a record.
If an error occurs for a particular item and "Continue On Fail" is enabled, the output for that item will contain an error field with the error message (and possibly additional error details).
Example output structure:

[
  {
    "json": {
      // Fields as returned by the Feishu API for each updated record
    }
  },
  {
    "json": {
      "error": "Error message here"
    }
  }
]

Binary data is not produced by this operation.

Dependencies

External Service: Requires access to the Feishu (Lark) Bitable API.
API Key/Credentials: Needs valid Feishu credentials configured in n8n under feishuCredentialsApi.
Environment: No special environment variables are mentioned, but network access to Feishu's API endpoints is necessary.

Troubleshooting

Common Issues:
- Invalid Credentials: If the Feishu credentials are incorrect or missing, authentication will fail.
- Malformed Request Body: If the "请求体JSON" property does not match the expected format, the API will return an error.
- Missing Required Fields: Omitting required properties like "多维表格 Token" or "多维表格 ID" will cause the node to throw errors.
- Idempotency Errors: Reusing the same "操作的唯一标识" (client_token) unintentionally may prevent updates due to idempotency constraints.
Error Messages:
- "未实现方法: bitable.bitable:table:record:batchUpdate": Indicates the selected resource/operation combination is not implemented in the node.
- "NodeApiError": Represents an error response from the Feishu API. Check the error field in the output for more details.
- Other thrown errors will appear in the output if "Continue On Fail" is enabled, otherwise they will stop execution.