Публичный APIРелизы7. DELETE /repos/{owner}/{repo}/releases/tags/{tag} — удалить релиз по тегу

7. DELETE /repos/{owner}/{repo}/releases/tags/{tag} — удалить релиз по тегу

Описание

Этот метод позволяет удалить релиз, связанный с указанным Git-тегом. Эта операция не удаляет сам Git-тег, только метаданные релиза и ассеты. Только пользователи с правами записи для репозитория могут удалять релиз.

Параметры URL:

ПараметрОбязательныйОписание
ownerДаВладелец репозитория (логин или имя организации)
repoДаНазвание репозитория без расширения .git
tagДаИмя тега релиза для удаления (например, ‘v1.0.0’)

Параметры запроса:

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

Тело запроса:

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

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

curl -X DELETE "https://api.gitverse.ru/repos/myuser/myrepo/releases/tags/v1.0.0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Ответ (204 No Content):

При успешном удалении возвращается статус 204 без тела ответа.

Коды ответов

КодСтатусОписание
204No ContentРелиз успешно удален
400Bad RequestНекорректные параметры запроса
403ForbiddenДоступ запрещен
404Not FoundРелиз или тег не найден
422Unprocessable EntityНевозможно обработать сущность
500Internal Server ErrorВнутренняя ошибка сервера

Примечания:

  • убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к репозиторию;
  • метод удаляет только метаданные релиза и ассеты, но не сам Git-тег;
  • после успешного удаления релиз становится недоступным для просмотра.