25.03.2026 15:10

Edit

[POST] .../v1/chatmessage/edit

Редактирует сообщение чата.

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

Название Тип данных Обязательность Описание
id String Обязательный UUID сообщения
text String Необязательный Новый текст сообщения
file_ids Array of Int64 Необязательный Новый список файлов

Ограничения и проверки

  • id обязателен и должен быть корректным UUID сообщения.
  • Метод доступен только пользователю, у которого есть доступ к чату сообщения.
  • Для обычных чатов проверяется право chat_message_edit (686).
  • Для чатов, связанных с Lead/Deal/Ticket/Task, редактирование наследует права сущности: требуется Edit у связанной сущности (заменяет права chat_message_*).
  • Для закрытого чата (closed = true) редактирование сообщения отклоняется с ошибкой 1220.
  • Нужно передать хотя бы одно поле для изменения: text или file_ids.
  • Если text передан пустой строкой, текст сообщения очищается.
  • Если file_ids передан пустым массивом, вложения очищаются.
  • Текст проходит серверную нормализацию markdown: поддерживаются только bold, italic, underline, strike, link, pre.
  • Все HTML-теги и неподдерживаемое форматирование удаляются из текста.
  • Для каждого переданного file_id выполняется та же нормализация, что и в ChatMessage/Add.
  • Если входной файл не является chat-owned system-файлом текущего чата, сервер создает его копию в папке чата и сохраняет уже новый file_id.
  • Файлы, удаленные из сообщения, физически удаляются только если на них больше нет ссылок из других неудаленных сообщений.

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

{
  "id": "9beec41f-6ef5-4e87-b4ea-05895cff2c54",
  "text": "Уточненное сообщение",
  "file_ids": [
    101
  ]
}

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

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

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": null
  }
}