Feishu Node icon

Feishu Node

Feishu Node

Overview

This node is designed to interact with Feishu's "多维表格" (Bitable) service, specifically to update the name of a data table within a Bitable application. It allows users to programmatically rename an existing table by providing the necessary identifiers and authentication token. This is useful in scenarios where automated workflows require dynamic management or organization of tables in Feishu Bitable, such as renaming tables based on workflow context or user input.

Practical Example:
Suppose you have a workflow that creates reports in Feishu Bitable and, after processing, needs to rename the report table to reflect its finalized status (e.g., from "Draft Report" to "Final Report"). This node enables such automation.

Properties

Name Type Meaning
多维表格 Token String The unique identifier (token) for the Bitable App. Required for access.
多维表格 ID String The unique identifier for the specific Bitable data table to update.
表格新名称 String The new name to assign to the specified table.

Output

The node outputs a JSON object reflecting the result of the update operation. If the operation is successful, the output will contain the response from the Feishu API regarding the table update. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example Success Output:

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

Example Error Output (with Continue On Fail):

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

Note: The exact structure of the success output depends on the Feishu API's response.

Dependencies

  • Feishu Credentials: Requires valid Feishu API credentials configured in n8n under feishuCredentialsApi.
  • External Service: Access to Feishu's Bitable API.
  • Environment: No additional environment variables are required beyond standard n8n credential configuration.

Troubleshooting

  • Missing Method Error:

    • Message: 未实现方法: bitable.bitable:table:update
    • Cause: The requested resource-operation combination is not implemented in the node.
    • Solution: Double-check that the resource and operation names are correct and supported.
  • Authentication Errors:

    • Occur if the provided Feishu Token is invalid or missing.
    • Solution: Ensure the "多维表格 Token" property is set correctly and that the credentials are valid.
  • Invalid Table ID:

    • If the "多维表格 ID" does not correspond to an existing table, the API will return an error.
    • Solution: Verify the table ID is correct and accessible with the provided token.
  • General API Errors:

    • Any other errors from the Feishu API will be surfaced in the error field if "Continue On Fail" is enabled.
    • Solution: Review the error message for details and consult Feishu API documentation.

Links and References

Discussion