---
title: "Pipeline stage edit"
method: PATCH
path: "/api/v4/leads/pipelines/{pipeline_id}/statuses/{id}"
---

# Pipeline stage edit

`PATCH /api/v4/leads/pipelines/{pipeline_id}/statuses/{id}`

This method allows editing a pipeline stage. You can pass stage descriptions (optional).

## Path parameters

- `pipeline_id` integer, required
- `id` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `name` string — Stage name
  - `sort` integer — Sequence number of the stage in the pipeline
  - `color` string — Stage color
  - `descriptions` object[] — Stage descriptions
    - `id` integer — ID of the stage description.
    - `level` string — Level of users the description is shown to. Those might be "newbie", "candidate" and "master".
    - `description` string — Stage description.

## Response `200`

200

- object
  - `id` integer
  - `name` string
  - `sort` integer
  - `is_editable` boolean
  - `pipeline_id` integer
  - `color` string
  - `type` integer
  - `account_id` integer
  - `request_id` string
  - `_links` object
    - `self` object
      - `href` string

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `500` — 500

---

[API](https://skmtc.dev/kommo/apis/kommo-api-references.md) · [All operations](https://skmtc.dev/kommo/apis/kommo-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kommo/kommo-api-references/revisions/f17af4d23c7c/schema)