---
title: "Move Deal To Pipeline"
method: POST
path: "/api/external/v2/deals/{deal_id}/pipeline"
tags: ["external-v2-pipelines"]
---

# Move Deal To Pipeline

`POST /api/external/v2/deals/{deal_id}/pipeline`

Add a deal to a pipeline or update its pipeline status (idempotent).

If the deal is already in the requested pipeline the status is updated
in-place; no duplicate row is created.  Supply ``pipeline_status_id`` to
target a specific status — omit it to default to the first status.

## Path parameters

- `deal_id` integer, required

## Request body

- MoveDealToPipelineRequest — Request body for POST /api/external/v2/deals/<id>/pipeline. Moves a deal into a pipeline (idempotent — if the deal is already in the pipeline the status is updated in place rather than creating a duplicate). Financing and acquisition pipelines may each appear at most once on a deal.
  - `pipeline_id` integer, required — ID of the pipeline to add the deal to
  - `pipeline_status_id` integer, nullable — ID of the pipeline status to set. Defaults to the first status in the pipeline.

## Response `200`

Successful Response

- DealPipelineObjectResponse — OpenAPI schema for POST /api/external/v2/deals/<id>/pipeline (object envelope).
  - `request_id` string, required
  - `timestamp` string, required
  - `data` DealPipelineData, required
    - `id` integer, required
    - `deal_id` integer, required
    - `pipeline_id` integer, required
    - `pipeline_status_id` integer, required
    - `status` string, required
    - `pipeline_name` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/lev/apis/lev-api.md) · [All operations](https://skmtc.net/lev/apis/lev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lev/lev-api/revisions/a586be7d6d3a/schema)