Feishu Node icon

Feishu Node

Feishu Node

Overview

This node is designed to interact with Feishu's "多维表格" (Bitable, or Multi-dimensional Table) feature, specifically for updating the metadata of a Bitable. It allows users to modify properties such as the table's name and advanced permission settings via n8n workflows. This is useful in scenarios where you need to automate the management of Feishu Bitables, such as renaming tables or toggling advanced permissions programmatically.

Practical examples:

  • Automatically update the name of a Bitable after a certain workflow step.
  • Enable or disable advanced permissions on a Bitable based on business logic.
  • Integrate Feishu Bitable management into larger automation processes.

Properties

Name Type Meaning
多维表格 Token String The App token of the target Bitable. Required for identifying which Bitable to update.
多维表格名称 String The new name for the Bitable App.
是否开启高级权限 Boolean Whether to enable advanced permissions for the Bitable.

Output

The node outputs a JSON object reflecting the result of the update operation. If the operation is successful, the output will contain the updated metadata of the Bitable. In case of an error (and if "Continue On Fail" is enabled), the output will include an error field with the error message, and possibly additional error details if available.

Example success output:

{
  "name": "新表格名称",
  "enable_advanced_permissions": true,
  // ...other metadata fields returned by the API
}

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

{
  "error": "Error message from Feishu API"
}

Dependencies

  • Feishu API: Requires access to Feishu's Bitable API.
  • API Credentials: You must configure feishuCredentialsApi in n8n with valid credentials (such as App ID and Secret).
  • n8n Configuration: Ensure that the Feishu credential type is set up in your n8n instance.

Troubleshooting

  • Missing or Invalid Token: If the "多维表格 Token" is missing or incorrect, the node will fail with an error indicating authentication or resource not found issues.
  • Insufficient Permissions: If the provided credentials do not have permission to update the specified Bitable, you may receive a permissions error from the Feishu API.
  • Unimplemented Method Error: If the resource or operation is not implemented, the node will throw an error like 未实现方法: bitable.bitable:updateMetadata.
  • API Errors: Any errors returned by the Feishu API (e.g., invalid parameters, network issues) will be surfaced in the output or as thrown errors.

How to resolve:

  • Double-check the App token and credentials.
  • Ensure the user associated with the credentials has sufficient permissions.
  • Verify that the resource and operation names are correct and supported by the node.

Links and References

Discussion