---
title: "Enrich Selection"
method: POST
path: "/api/v1/workspace/companies/enrich-selection"
tags: ["workspace"]
---

# Enrich Selection

`POST /api/v1/workspace/companies/enrich-selection`

## Request

- Base URL: `https://api.getnivara.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getnivara.com/api/v1/workspace/companies/enrich-selection`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getnivara/apis/nivara-api/docs/api/v1/workspace/companies/enrich-selection/post.ts> (a function with typed inputs; its response is checked against the schema)

Enrich companies identified by a SelectionSpec.

## Request body

- EnrichSelectionRequest
  - `selection` SelectionSpec, required
    - `mode` 'explicit' | 'allMatching', required
    - `business_ids` integer[], nullable
    - `exclude_business_ids` integer[], nullable
    - `query` SelectionQuery
      - `collection_id` integer, nullable
      - `funnel_stage` string, nullable
      - `stage` string, nullable
      - `q` string, nullable
      - `has_location` string, nullable
      - `has_rating` string, nullable
      - `min_rating` number, nullable
      - `max_rating` number, nullable
      - `ai_column_id` integer, nullable
      - `ai_value` string, nullable
      - `unenriched_column_id` integer, nullable
  - `agent` string, required
  - `config` object

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getnivara/apis/nivara-api.md) - [All operations](https://skmtc.dev/getnivara/apis/nivara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getnivara/apis/nivara-api/revisions/2810c849c6a4?raw)