> ## Documentation Index
> Fetch the complete documentation index at: https://docs.databar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Run enrichment in table

> Run a specific enrichment or waterfall on a table.

Works for both enrichments (from `POST /v1/table/{uuid}/add-enrichment`) and waterfalls (from `POST /v1/table/{uuid}/add-waterfall`). Use the `id` returned when adding.

**run_strategy** controls which rows are processed:
- `run_all` (default) — run on every row.
- `run_empty` — only run on rows where the result is empty.

**row_ids** (optional) — list of specific row UUIDs to process. When provided, only those rows are processed (subject to run_strategy).

## enrichment\_id

The `enrichment_id` path parameter is the **table-enrichment ID** — the `id` returned by `GET /v1/table/{table_uuid}/enrichments`.

This is **not** the same as the enrichment catalog ID. You must first add the enrichment to the table via `POST /v1/table/{table_uuid}/add-enrichment`, then retrieve the table-enrichment ID from `GET /v1/table/{table_uuid}/enrichments`.


## OpenAPI

````yaml /api-reference/openapi.json POST /v1/table/{table_uuid}/run-enrichment/{enrichment_id}
openapi: 3.1.0
info:
  title: Databar.ai API
  description: >-

    # Authentication


    Databar uses API keys to allow access to the API. You can find your API key
    in your workspace home page, but to use the REST API you’ll first need to
    schedule a call with us.

    Our API expects the API key to be included in all API requests to the server
    in the Header of your request with the key `x-apikey`.

    To find your API key, head over to your Databar workspace and click
    Integrations.


    **Example:**


    `bash

    curl https://api.databar.ai/v1/user/me -H x-apikey: {YOUR_API_KEY}`
  contact:
    email: info@databar.ai
  version: 0.1.2
servers:
  - url: https://api.databar.ai
    description: Production
security: []
paths:
  /v1/table/{table_uuid}/run-enrichment/{enrichment_id}:
    post:
      tags:
        - Table
      summary: Run table enrichment or waterfall
      description: >-
        Run a specific enrichment or waterfall on a table.


        Works for both enrichments (from `POST /v1/table/{uuid}/add-enrichment`)
        and waterfalls (from `POST /v1/table/{uuid}/add-waterfall`). Use the
        `id` returned when adding.


        **run_strategy** controls which rows are processed:

        - `run_all` (default) — run on every row.

        - `run_empty` — only run on rows where the result is empty.


        **row_ids** (optional) — list of specific row UUIDs to process. When
        provided, only those rows are processed (subject to run_strategy).
      operationId: >-
        Run_table_enrichment_or_waterfall_v1_table__table_uuid__run_enrichment__enrichment_id__post
      parameters:
        - name: table_uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: The UUID of the table
            title: Table Uuid
          description: The UUID of the table
        - name: enrichment_id
          in: path
          required: true
          schema:
            type: string
            description: The ID of the table enrichment to run
            title: Enrichment Id
          description: The ID of the table enrichment to run
        - name: x-apikey
          in: header
          required: true
          schema:
            type: string
            title: API Key
            description: API Key for authentication
          description: API Key for authentication
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
                - $ref: '#/components/schemas/RunEnrichmentRequest'
                - type: 'null'
              title: Data
      responses:
        '200':
          description: Enrichment run started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunEnrichmentResponse'
              example:
                status: queued
                processing_rows: 150
        '403':
          description: Forbidden
          content:
            application/json:
              example:
                detail: Not allowed
        '404':
          description: Table or enrichment not found
          content:
            application/json:
              example:
                detail: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    RunEnrichmentRequest:
      properties:
        run_strategy:
          type: string
          enum:
            - run_all
            - run_empty
            - run_errors
          title: Run Strategy
          description: >-
            Which rows to process: 'run_all' runs every row, 'run_empty' skips
            rows that already have a result, 'run_errors' reruns only rows that
            ended with an error.
          default: run_all
        row_ids:
          anyOf:
            - items:
                type: string
                format: uuid
              type: array
            - type: 'null'
          title: Row Ids
          description: >-
            Optional list of specific row UUIDs to process. When omitted,
            processes all rows (subject to run_strategy).
      type: object
      title: RunEnrichmentRequest
    RunEnrichmentResponse:
      properties:
        status:
          type: string
          title: Status
        processing_rows:
          anyOf:
            - type: integer
            - type: 'null'
          title: Processing Rows
      type: object
      required:
        - status
      title: RunEnrichmentResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````