Удалить комментарий

DELETE /v1/tasks/:taskId/comments/:id

Удаляет комментарий задачи. Доступно только на порталах со старой карточкой задачи: на новой карточке метод возвращает 410 GONE. Восстановить удалённый комментарий через API нельзя.

Параметры

Параметр Тип Обяз. Описание
taskId (path) number да ID задачи
id (path) number да ID комментария

Примеры

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/tasks/289/comments/36559" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X DELETE "https://vibecode.bitrix24.tech/v1/tasks/289/comments/36559" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

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

if (res.status === 204) {
  console.log('Комментарий удалён')
} else if (res.status === 410) {
  const { error } = await res.json()
  console.log('Новая карточка — удаление недоступно:', error.message)
}

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

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

Ответ

При успешном удалении на старой карточке возвращается HTTP-статус 204 No Content с пустым телом — признак успеха проверяется по статусу. На новой карточке вместо 204 приходит 410 GONE с JSON-телом (см. ниже).

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

Старая карточка:

HTTP/1.1 204 No Content

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

410 — новая карточка задачи (метод недоступен):

JSON 
{
  "success": false,
  "error": {
    "code": "GONE",
    "message": "Bitrix24 disabled update/delete for task comments in the new task card. To remove a comment, delete the source task or ask a portal admin to remove the message via the chat UI.",
    "hint": "Verified against apidocs.bitrix24.ru on 2026-05-09 — the modern task-chat API accepts only new messages, no edit or delete."
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS taskId или id не являются положительными целыми
410 GONE Задача создана на новой карточке — удаление комментария на стороне Битрикс24 недоступно
403 SCOPE_DENIED API-ключ не имеет скоупа task
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

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

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

Альтернатива для новой карточки. Способов программно удалить отправленный комментарий нет. Если содержимое нужно скрыть — удалите задачу целиком (`DELETE /v1/tasks/:id`), либо попросите администратора портала удалить сообщение через интерфейс чата.

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