---
title: "Promote Selection"
method: POST
path: "/api/v1/workspace/collections/{collection_id}/promote-selection"
tags: ["workspace"]
---

# Promote Selection

`POST /api/v1/workspace/collections/{collection_id}/promote-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/collections/{collection_id}/promote-selection`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getnivara/apis/nivara-api/docs/api/v1/workspace/collections/:collection_id/promote-selection/post.ts> (a function with typed inputs; its response is checked against the schema)

Promote companies identified by a SelectionSpec to a funnel stage.

## Path parameters

- `collection_id` integer, required

## Request body

- PromoteSelectionRequest
  - `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
  - `to_stage` 'qualify' | 'contacts' | 'export', required

## 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)