---
title: "Update a Pipeline"
method: PUT
path: "/pipeline/{id}/"
tags: ["pipelines"]
---

# Update a Pipeline

`PUT /pipeline/{id}/`

You can use this endpoint to:

* Rename a Pipeline.
* Reorder Opportunity Statuses within a Pipeline.
* Move an Opportunity Status from a different Pipeline into this one.
    * To do so, include `{"id": "id_of_the_status_from_another_pipeline"}` in the `statuses` list.

## Path parameters

- `id` string, required

## Request body

- UpdatePipeline
  - `name` string
  - `statuses` ExistingPipelineOpportunityStatus[], nullable — Opportunity Statuses of this Pipeline, in the desired order.
    - `id` string, required — ID of an existing Opportunity Status. May belong to a different Pipeline, in which case the status is moved into this one.

## Response `200`

Successful response

- Pipeline
  - `created_by` string, nullable, required
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `id` string, required
  - `name` string, required
  - `organization_id` string, required
  - `statuses` PipelineOpportunityStatus[], required
    - `id` string, required
    - `label` string, required
    - `type` 'won' | 'lost' | 'active', required
  - `updated_by` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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