Удаление комментария к задаче или запросу на слияние

DELETE /repos/{owner}/{repo}/issues/{pull_id}/comments/{comment_id}

Описание

Метод DELETE удаляет указанный комментарий к задаче или запросу на слияние в репозитории.

Ответ на запрос не содержит тела. Статус HTTP-ответа указывает на результат операции:

  • код 204 No Content означает, что комментарий был успешно удален;
  • код 404 Not Found означает, что комментарий не найден или не существует.

Этот метод полезен для автоматизации процессов, например, для удаления устаревших комментариев бота или очистки обсуждения перед слиянием запроса.

Заголовки

ПараметрОбязательныйОписание
acceptНетТип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest

Параметры пути

В URL запроса необходимо передать следующие идентификаторы ресурса:

ПараметрТипОбязательныйОписание
ownerstringДаВладелец репозитория (пользователь или организация)
repostringДаНазвание репозитория
pull_idintegerДаНомер запроса на слияние
comment_idintegerДаУникальный идентификатор комментария

Параметры запроса и тело запроса

Данный метод не принимает параметров строки запроса и не требует тела запроса.

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

Ниже приведен пример использования curl для удаления комментария с id=789 в запросе на слияние с номером 42 репозитория my-repo организации my-org.

curl -X DELETE "https://api.gitverse.ru/repos/my-org/my-repo/issues/42/comments/789" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1"

Замените YOUR_TOKEN на ваш личный токен доступа. Заголовок Accept фиксирует использование первой версии API.

Ответ при успешном удалении (204 No Content)

Если комментарий был успешно удален, сервер вернет ответ с кодом 204 No Content. Тело ответа будет пустым.

Коды ответа

Результат выполнения запроса определяется по HTTP-статусу:

КодСтатусОписание
204No ContentКомментарий успешно удален.
400Bad RequestОдин из параметров передан некорректно.
401UnauthorizedНе передан или невалиден токен авторизации.
403ForbiddenНет прав на удаление комментария (комментарий создан другим пользователем, либо недостаточно прав в репозитории).
404Not FoundРепозиторий, запрос на слияние или комментарий не найдены.
500Internal Server ErrorВнутренняя ошибка сервера.

Формат ответа и заголовки

Так как метод возвращает только статус без тела, формат содержимого (Content-Type) не применяется. Однако заголовок Accept в запросе должен быть установлен в application/vnd.gitverse.object+json;version=1.