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

# Promote Companies

`POST /api/v1/workspace/collections/{collection_id}/promote`

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

Move companies to a different funnel stage within a collection.

## Path parameters

- `collection_id` integer, required

## Request body

- PromoteRequest
  - `company_ids` integer[], required
  - `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)