Aitable Unofficial icon

Aitable Unofficial

Interact with Aitable.ai API (Unofficial Integration)

Actions5

Overview

This node allows users to interact with the Aitable.ai platform, specifically enabling searching for various types of nodes within a given space. The "Search Nodes" operation lets you query nodes such as dashboards, datasheets, folders, forms, or mirrors by their type, name (with partial matching), and permission levels.

Common scenarios include:

  • Quickly finding specific datasheets or dashboards within a large workspace.
  • Filtering nodes based on user permissions to identify accessible resources.
  • Automating workflows that require dynamic retrieval of node information from Aitable.ai.

For example, you could use this node to search for all datasheets in a particular space whose names contain "Project" and where you have at least editor-level access.

Properties

Name Meaning
Space ID The unique identifier of the Aitable space to search within (e.g., spcX9P2xUcKst).
Node Type The type of node to search for. Options: Dashboard, Datasheet, Folder, Form, Mirror.
Query Optional text string to search nodes by name; supports partial matches.
Permissions Filter nodes by permission levels. Multiple selections allowed. Options:
- Manager (0): Full management permissions
- Editor (1): Can edit but not manage
- Update-only (2): Can add and edit records but not delete
- Read-only (3): Can only view data

Output

The output is an array of JSON objects representing the nodes found matching the search criteria. Each item contains the full node data as returned by the Aitable API under the json field.

If no nodes are found or an error occurs, the output will contain a JSON object with:

  • success: false
  • message: explanation of the failure
  • response: raw API response for debugging

No binary data is produced by this operation.

Dependencies

  • Requires an active connection to the Aitable.ai API.
  • Needs an API authentication token configured in n8n credentials (referred generically as "an API key credential").
  • The node uses HTTP GET requests to the Aitable API endpoint https://aitable.ai/fusion/v1/spaces/{spaceId}/nodes.

Troubleshooting

  • Common issues:

    • Invalid or missing Space ID will cause the API call to fail.
    • Incorrect or expired API authentication token will result in authorization errors.
    • Providing unsupported node types or malformed query strings may return empty results.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "No data returned or error occurred": Indicates the API did not return expected node data; verify parameters and API status.
    • Errors related to authentication or permissions usually indicate invalid credentials or insufficient access rights.
    • If the node throws an error about missing required parameters like Space ID, ensure these are correctly set.

  • Resolution tips:

    • Double-check the Space ID format and existence in your Aitable account.
    • Verify your API key credential is valid and has necessary permissions.
    • Use the query parameter carefully; try broad searches first to confirm connectivity.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully during workflow execution.

Links and References

Discussion