Add waterfall to table

curl --request POST \
  --url https://api.databar.ai/v1/table/{table_uuid}/add-waterfall \
  --header 'Content-Type: application/json' \
  --header 'x-apikey: <x-apikey>' \
  --data '
{
  "waterfall": "email_getter",
  "enrichments": [
    833,
    966
  ],
  "mapping": {
    "first_name": "first_name",
    "last_name": "last_name",
    "company": "company"
  },
  "email_verifier": 10
}
'

{
  "id": 42,
  "waterfall_name": "Email finder waterfall"
}

{
  "detail": "Column 'company' not found in the table"
}

{
  "detail": "Not allowed"
}

{
  "detail": "Table not found"
}

{
  "error": "<string>",
  "detail": "<string>",
  "fields": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>"
    }
  ]
}

POST

table

{table_uuid}

add-waterfall

curl --request POST \
  --url https://api.databar.ai/v1/table/{table_uuid}/add-waterfall \
  --header 'Content-Type: application/json' \
  --header 'x-apikey: <x-apikey>' \
  --data '
{
  "waterfall": "email_getter",
  "enrichments": [
    833,
    966
  ],
  "mapping": {
    "first_name": "first_name",
    "last_name": "last_name",
    "company": "company"
  },
  "email_verifier": 10
}
'

{
  "id": 42,
  "waterfall_name": "Email finder waterfall"
}

{
  "detail": "Column 'company' not found in the table"
}

{
  "detail": "Not allowed"
}

{
  "detail": "Table not found"
}

{
  "error": "<string>",
  "detail": "<string>",
  "fields": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>"
    }
  ]
}

Headers

x-apikey

string

required

API Key for authentication

Path Parameters

table_uuid

string<uuid>

required

The UUID of the table

Body

application/json

waterfall

string

required

Waterfall identifier (e.g. 'email_getter'). Get from GET /v1/waterfalls.

mapping

Mapping · object

required

Maps waterfall parameter names to table column identifiers (UUID) or column names (the key used in GET /v1/table/{uuid}/rows response). Get column identifiers from GET /v1/table/{uuid}/columns.

Show child attributes

enrichments

integer[]

Provider IDs to use in the waterfall cascade, in order. Get available IDs from GET /v1/waterfalls/{identifier}. Omit or pass [] to attach the default cascade (providers with enabled_by_default=true).

email_verifier

integer | null

Optional enrichment ID for email verification (only for email waterfalls).

Response

Waterfall added successfully

integer

required

waterfall_name

string

required

Getting Started

Overview

SDKs

Workspace

Workbooks

Tables

Headless

User

Headers

Path Parameters

Body

Response