09.06.2026 00:00

SetPinned

[POST] .../v1/chatmessage/setpinned

Изменяет признак закрепления сообщения в чате.

При успешном изменении публикуется websocket/webhook-событие ChatMessagePinnedSet.

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

Название Тип данных Обязательность Описание
id String Обязательный UUID сообщения
pinned Boolean Обязательный true - закрепить сообщение, false - снять закрепление

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

  • Метод является write-операцией и недоступен, если запись в чат запрещена текущим состоянием чата или связанной сущности.

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

{
  "id": "9beec41f-6ef5-4e87-b4ea-05895cff2c54",
  "pinned": true
}

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

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

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": ["9beec41f-6ef5-4e87-b4ea-05895cff2c54"]
  }
}