Waterfall → Run
AI-generatedOverview
This node interacts with the Databar.ai API to run waterfall tasks, which are sequences of data enrichment operations using multiple data providers. It allows users to select a specific waterfall, input parameters either through guided fields or raw JSON, choose data providers to use in the waterfall, and optionally wait for the task to complete to retrieve results automatically. This is useful for automating complex data enrichment workflows where multiple providers are tried in sequence until a successful result is obtained.
Use Case Examples
- Running a waterfall to enrich customer data by providing first name, last name, and company parameters.
- Selecting specific data providers to use in the waterfall to control which enrichment sources are queried.
- Waiting for the waterfall task to complete and automatically retrieving the enriched data for further processing in a workflow.
Properties
| Name | Meaning |
|---|---|
| Waterfall | Select the specific waterfall to run, which defines the sequence of data enrichment providers to use. |
| Parameter Input Mode | Choose how to input the parameters for the waterfall: either through individual guided fields or as a raw JSON object. |
| Parameters | The input parameters for the waterfall, either mapped through individual fields or provided as raw JSON, depending on the selected input mode. |
| Data Providers | Select which data providers to use in the waterfall. The waterfall will try each provider in order until a successful result is returned. |
| Wait for Completion | Whether to wait for the waterfall task to complete and return results automatically. |
| Additional Options | Additional options for waiting, including poll interval (how often to check for completion) and timeout (maximum time to wait for completion). |
Output
JSON
task_id- Identifier of the initiated waterfall task.status- Current status of the waterfall task (e.g., running, completed, failed).result- Result data returned by the waterfall task upon completion.error- Error message if the task failed or an error occurred.
Dependencies
- Databar.ai API
- An API key credential for authentication
Troubleshooting
- Ensure the selected waterfall identifier is valid and accessible with your API key.
- Parameters must be valid JSON when using raw JSON input mode; invalid JSON will cause errors.
- If waiting for completion, the task may time out if it takes longer than the specified timeout period.
- Errors from the API such as task failure will be reported with messages; check the error details for troubleshooting.
Links
- Databar.ai API Documentation - Official API documentation for understanding available endpoints and parameters.