Список комментариев

GET /v1/tasks/:taskId/comments

Возвращает комментарии конкретной задачи. На новой карточке задачи список читается из чата, системные сообщения отфильтрованы. На старой — из блока комментариев в самой карточке.

Параметры

Примеры

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

curl "https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc" \
  -H "X-Api-Key: YOUR_API_KEY"

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

curl "https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

const url = 'https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc'
const res = await fetch(url, {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data, meta } = await res.json()
console.log(`Получено ${data.length} комментариев`)

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

const url = 'https://vibecode.bitrix24.tech/v1/tasks/289/comments?limit=20&sort=id:desc'
const res = await fetch(url, {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data, meta } = await res.json()

Поля ответа

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

{
  "success": true,
  "data": [
    {
      "id": 36559,
      "taskId": 289,
      "authorId": 1,
      "message": "Добавил черновик отчёта в комментарии — посмотри, пожалуйста.",
      "createdAt": "2026-05-13T12:30:58.000Z"
    },
    {
      "id": 36557,
      "taskId": 289,
      "authorId": 79,
      "message": "[USER=99]Зуля[/USER], готово, спасибо.",
      "createdAt": "2026-05-12T15:11:04.000Z"
    }
  ],
  "meta": {
    "total": 2,
    "hasMore": false
  }
}

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

400 — taskId не положительное целое:

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "taskId must be a positive integer"
  }
}

Ошибки

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

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

Окно просмотра при фильтрации. На новой карточке запрос с filter или сортировкой не по ID просматривает до 2000 самых новых сообщений чата задачи, включая системные уведомления, и отбирает подошедшие комментарии из них. Если история задачи длиннее или ограничена тарифом портала, приходит meta.truncated: true: за границей окна остались комментарии, которых нет в ответе, а meta.total считает только попавшие в окно. Это не признак следующей страницы — offset окно не сдвинет. Сузьте выборку фильтром по POST_DATE или AUTHOR_ID. По той же причине ?sort=post_date:asc на такой задаче вернёт самые старые комментарии в пределах окна, а не самые старые в задаче.

Фильтр и сортировка по автору — через AUTHOR_ID. Поля AUTHOR_NAME и AUTHOR_EMAIL принимаются на старой карточке и возвращают 400 на новой, поэтому запрос по имени автора работает не на каждом портале. Чтобы выборка не зависела от того, как настроен портал, найдите сотрудника через GET /v1/users и фильтруйте или сортируйте по AUTHOR_ID.

Пустая страница при meta.hasMore: true. Системные уведомления о постановке задачи, смене срока и назначении исполнителя отфильтровываются на стороне API. На запросе без filter и с сортировкой по ID, если весь текущий срез состоит из них, data приходит пустым при meta.hasMore: true. На этом пути чтения meta.total — оценка, и в таком срезе она приходит равной 1 при пустом data. Это не ошибка: ведите пагинацию по meta.hasMore и содержимому data, а не по meta.total — запросите следующую страницу или увеличьте limit.

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

• Получить комментарий
• Создать комментарий
• Пакет операций
• Задачи
• Лимиты и оптимизация