---
title: "Edição de Etapa do Pipeline"
method: PATCH
path: "/api/v4/leads/pipelines/{pipeline_id}/statuses/{id}"
---

# Edição de Etapa do Pipeline

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

## Request

- Base URL: `https://subdomain.kommo.com`
- URL: `https://subdomain.kommo.com/api/v4/leads/pipelines/{pipeline_id}/statuses/{id}`
- Auth: OAuth 2

Este método permite editar uma etapa do pipeline. Você pode passar descrições de etapas (opcionalmente).

## Path parameters

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

## Request body

- object
  - `name` string: Nome da Etapa
  - `sort` integer: Número de sequência da etapa no pipeline
  - `color` string: Cor da Etapa
  - `descriptions` object[]: Descrição da Etapa
    - `level` 'newbie' | 'candidate' | 'master': O nível de usuários para os quais a descrição do status é exibida.
    - `description` string: Descrição de status

## 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/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)