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

Запрос позволяет удалить комментарий сущности.

DELETE

https://api.tracker.yandex.net/v3/entities/{тип_сущности}/{id_сущности}/comments/{id_комментария}

Формат запроса

Перед выполнением запроса получите доступ к API.

Для удаления комментария используйте HTTP-запрос с методом DELETE.

DELETE /v3/entities/{тип_сущности}/{id_сущности}/comments/{id_комментария}
Host: api.tracker.yandex.net
Authorization: OAuth API_TOKEN
X-Org-ID или X-Cloud-Org-ID: ИДЕНТИФИКАТОР_ОРГАНИЗАЦИИ
Заголовки

  • Host: адрес узла, предоставляющего API.

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth OAUTH_TOKEN при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer IAM_TOKEN при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Identity Hub. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • если к Трекеру привязана организация Яндекс 360 для бизнеса, используйте заголовок X-Org-ID,

    • если к Трекеру привязана организация Yandex Identity Hub, используйте заголовок X-Cloud-Org-ID.

    Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

Ресурс
Параметр Описание Тип данных
тип_сущности Тип сущности:
  • project — проект;
  • portfolio — портфель;
  • goal — цель
 Строка
id_сущности Идентификатор сущности. Чтобы получить идентификатор, посмотрите список сущностей. Строка
id_комментария Уникальный идентификатор комментария. Строка или число
Параметры запроса

Дополнительные параметры

Параметр Описание Тип данных
notify Уведомлять пользователей, которые указаны в полях Автор, Ответственный, Участники, Заказчики и Наблюдатели. Значение по умолчанию — true. Логический
notifyAuthor Уведомлять автора изменений. Значение по умолчанию — false. Логический

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

  • Используется HTTP-метод DELETE.
DELETE https://api.tracker.yandex.net/v3/entities/project/PROJECT_ID/comments/16

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 204.

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

400
Один или несколько параметров запроса имеют недопустимое значение.
404
Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
422
Ошибка валидации JSON, запрос отклонен.
Предыдущая
Получить комментарий
Следующая
Создать чеклист или добавить в него пункты