Overview

This node interacts with the Databar.ai API to manage and run waterfall tasks, which are sequences of data enrichment providers. It allows users to get details of a specific waterfall, list all available waterfalls, or run a waterfall task with specified parameters and data providers. This is useful for automating data enrichment workflows where multiple providers are tried in sequence until a successful result is obtained. For example, a user can select a waterfall, provide input parameters, and run the waterfall to enrich data automatically, optionally waiting for the task to complete and retrieving the results.

Use Case Examples

1. Get details of a specific waterfall by selecting it from a dropdown.
2. Run a waterfall task by providing parameters either as guided fields or raw JSON, selecting which data providers to use, and optionally waiting for completion to get results automatically.

Properties

Output

JSON

• task_id - Identifier of the task when running a waterfall.
• status - Status of the waterfall task or details of the waterfall when retrieved.
• result - Result data returned after the waterfall task completes.
• error - Error message if the operation fails and continueOnFail is enabled.

Dependencies

• Databar.ai API access with an API key credential

Troubleshooting

• Ensure the waterfall identifier is valid and selected before running or getting details.
• Parameters must be valid JSON objects if using raw JSON input mode; otherwise, an error is thrown.
• If waiting for completion, the node polls the API and may time out if the task takes too long; adjust poll interval and timeout settings accordingly.
• Common errors include invalid waterfall ID, invalid JSON parameters, and API request failures. Check API key permissions and network connectivity.

Links

• Databar.ai Waterfalls API - Official API endpoint documentation for managing waterfalls.