28.05.2026 00:00

Edit

[POST] .../v1/lead/edit

Редактирует CRM-обращение (Lead).

Входные параметры

Название Тип данных Обязательность Описание
id Int64 Обязательный ID обращения
stage_id Int64 Необязательный Изменение стадии через edit запрещено; используйте lead/setstage
title String Необязательный Тема обращения
description String Необязательный Описание обращения
description_mentions Array of CommonMentionInput Необязательный Новый список структурированных упоминаний в description
mention_options CommonMentionOptions Необязательный Опции обработки упоминаний
amount Decimal Необязательный Сумма обращения
fields Array of FieldValueEdit Необязательный Изменения дополнительных полей

Если передан stage_id, метод возвращает ошибку stage_id_use_setstage.
Если передан description_mentions, поле description обязательно. При mention_options.add_missing_users_to_context = true упомянутые пользователи добавляются в участники обращения; для этого требуется право управления участниками обращения.

Пример запроса

{
  "id": 105,
  "title": "Повторный контакт",
  "description": "Клиент подтвердил интерес, ждём документы",
  "amount": 3000.00,
  "fields": []
}

Выходные параметры

Название Тип данных Описание
result.row_affected Int64 Количество измененных строк
result.ids Array of Int64 ID измененных записей

Пример ответа

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [105]
  }
}