---
title: "Изменить воронку"
method: PATCH
path: "/api/v1/crm/pipelines/{id}"
tags: ["CRM pipelines"]
---

# Изменить воронку

`PATCH /api/v1/crm/pipelines/{id}`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/pipelines/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Изменяет указанную воронку CRM.

## Request body

- CRMPipelinePatch
  - `name` string
  - `is_default` boolean
  - `business_id` string, uuid
  - `auto_order_on_win` boolean: «Создавать заказ при выигрыше»; поле не передано — не менять

## Response `200`

Обновлённая воронка

- CRMPipeline
  - `id` string, uuid, required
  - `name` string, required
  - `label_key` string: Ключ подписи строки, которую завёл стартовый посев или готовый набор CRM (например crm.lead_stage.unsorted, crm.set.pipeline.patients, crm.source.manual): экран переводит подпись по ключу, а name остаётся прежним представлением. Пусто - кабинет назвал строку сам, показывается name как есть
  - `sort_order` integer, required
  - `is_default` boolean, required
  - `is_active` boolean, required
  - `is_system` boolean, required: «Общая» воронка, как в Битрикс24: есть в кабинете всегда, удалить её нельзя (409 crm.pipeline_system), даже если основной сделали другую. Название и стадии меняют как у любой воронки
  - `business_id` string, uuid, required
  - `auto_order_on_win` boolean, required: «Создавать заказ при выигрыше»: сделка воронки на выигранном этапе сама заводит черновик заказа в «Продажах». Работает только при подключённом «Документообороте»
  - `stages` CRMStage[], nullable
    - `id` string, uuid, required
    - `pipeline_id` string, uuid, required
    - `name` string, required
    - `label_key` string: Ключ подписи строки, которую завёл стартовый посев или готовый набор CRM (например crm.lead_stage.unsorted, crm.set.pipeline.patients, crm.source.manual): экран переводит подпись по ключу, а name остаётся прежним представлением. Пусто - кабинет назвал строку сам, показывается name как есть
    - `sort_order` integer, required
    - `category` 'open' | 'won' | 'lost', required: Категория стадии; won и lost закрывают сделку
    - `color` string, required
    - `probability` integer, required
    - `sla_hours` integer, required: Норматив пребывания на стадии в часах; 0 - без норматива
    - `required_fields` CRMRequiredField[], nullable, required
    - `is_active` boolean, required
    - `show_on_board` boolean: Показывать ли этап проигрыша (category lost) колонкой на доске сделок. Решает кабинет, по умолчанию нет; для открытых и выигрышных этапов признак ничего не меняет - они на доске всегда
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)