---
title: "Editar una etapa del pipeline"
method: PATCH
path: "/api/v4/leads/pipelines/{pipeline_id}/statuses/{id}"
---

# Editar una etapa del pipeline

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

Este método permite editar una etapa del pipeline. Puedes pasar descripciones de la etapa (opcional).

## Path parameters

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

## Headers

- `Content-Type` string

## Request body

- object
  - `name` string — Nombre de la etapa
  - `sort` integer — Número de secuencia de la etapa en el pipeline
  - `color` string — Color de la etapa
  - `descriptions` object[] — Descripciones de las etapas
    - `level` 'newbie' | 'candidate' | 'master' — El nivel de usuarios para el cual se muestra la descripción del estado
    - `description` string — Descripción del estado

## 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
- `429` — 429
- `500` — 500

---

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