Databar icon

Databar

Interact with Databar.ai API for data enrichment and table management

Actions6

Enrichment → Run

AI-generated

Overview

This node interacts with the Databar.ai API to perform data enrichment tasks. Specifically, the 'Enrichment - Run' operation allows users to run a single enrichment task by selecting an enrichment either from a list or by entering its ID manually. Users can input parameters for the enrichment either through guided fields or by providing raw JSON. The node supports waiting for the enrichment task to complete and can poll the API for task status until completion or timeout. This is useful for scenarios where users want to enrich data records with additional information, such as verifying emails or appending data from external sources.

Use Case Examples

  1. A user selects an email verification enrichment from the list, inputs the email address via guided fields, and runs the enrichment to get verification results.
  2. A user manually enters an enrichment ID for a custom enrichment, provides parameters as raw JSON, and waits for the task to complete to retrieve enriched data.

Properties

Name Meaning
Enrichment Selection How to select the enrichment to run, either from a list of available enrichments or by entering the enrichment ID manually.
Enrichment The enrichment to use, selected from a list of available enrichments (shown if selection mode is 'From List').
Enrichment ID The enrichment ID to use, entered manually (shown if selection mode is 'By ID').
Parameter Input Mode How to input the parameters for the enrichment, either using guided individual fields or raw JSON input.
Parameters The parameters for the enrichment, either mapped via guided fields or provided as raw JSON depending on the input mode.
Wait for Completion Whether to wait for the enrichment task to complete and return results automatically.
Additional Options Additional options for waiting, including poll interval and timeout settings when waiting for completion.

Output

JSON

  • task_id - The unique identifier of the enrichment task.
  • status - The status of the enrichment task (e.g., completed, failed).
  • result - The result data returned from the enrichment task upon completion.
  • error - Error message if the task failed.

Dependencies

  • Databar.ai API
  • An API key credential for authentication

Troubleshooting

  • Invalid enrichment ID: Ensure the enrichment ID is a valid number and corresponds to an existing enrichment.
  • Invalid JSON parameters: When using raw JSON input mode, ensure the JSON is well-formed and valid.
  • Timeout errors: If waiting for completion, the task may time out if it takes longer than the specified timeout. Increase the timeout or check the API status.
  • API errors: Check that the API key has the necessary permissions and that the Databar.ai service is reachable.

Links

Discussion