Для AI-агентов: markdown этой страницы — /docs-content/chats/messages/comments-subscription-delete.md индекс документации — /llms.txt

Перестать следить за комментариями поста

DELETE /v1/chats/messages/:messageId/comments/subscription

Отписывает вас от уведомлений о новых комментариях к посту канала.

Параметры

Параметр Тип Обяз. По умолч. Описание
messageId (path) number да — ID поста канала, положительное целое. Посты канала — Чтение сообщений

Тело не нужно. Параметры запроса и поля тела отклоняются с 400 INVALID_PARAMS.

Примеры

curl — личный ключ

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/chats/messages/845/comments/subscription" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/chats/messages/845/comments/subscription" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/chats/messages/845/comments/subscription', {
  method: 'DELETE',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const { data } = await res.json()
console.log('Уведомления выключены:', data.result)

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/chats/messages/845/comments/subscription', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { data } = await res.json()
console.log('Уведомления выключены:', data.result)

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data.result boolean true — вы больше не следите за комментариями поста

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

JSON 
{
  "success": true,
  "data": { "result": true }
}

Пример ответа при ошибке

422 — сообщение не пост канала:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "WRONG_PARENT_CHAT",
    "b24Code": "WRONG_PARENT_CHAT"
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS messageId не положительное целое, тело не JSON-объект, передан параметр запроса или поле тела. Проверяется до обращения к Битрикс24
404 ENTITY_NOT_FOUND Битрикс24 вернул общий код «не найдено» или ошибку с текстом «не найдено». Код портала — в error.b24Code
422 BITRIX_ERROR Битрикс24 вернул ошибку, код портала — в error.b24Code. WRONG_PARENT_CHAT — сообщение не пост канала, MESSAGE_ACCESS_DENIED — нет доступа к сообщению, в том числе когда сообщения с таким ID нет
403 SCOPE_DENIED API-ключ не имеет скоупа im
403 WRITE_BLOCKED_READONLY_KEY Ключ только для чтения: отписка изменяет данные — см. права доступа
401 TOKEN_MISSING API-ключ не имеет настроенных токенов Битрикс24

Полный список общих ошибок API — Ошибки.

Известные особенности

Отписка отмечает ветку прочитанной. Кроме уведомлений, отписка отмечает для вас прочитанными комментарии этого поста.

Повторная отписка не ошибка. Если вы уже не следите за постом, ответ тоже true.

Ветка появляется вместе с постом. Ветка заводится, как только пост отправлен в канал, ещё до первого комментария. У пересланного поста ветки нет — отписка создаёт её, поэтому отписаться можно от любого поста канала.

Смотрите также