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 без тела ответа.
Коды ответов
Код | Статус | Описание |
---|---|---|
204 | No Content | Релиз успешно удален |
400 | Bad Request | Некорректные параметры запроса |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Релиз или тег не найден |
422 | Unprocessable Entity | Невозможно обработать сущность |
500 | Internal Server Error | Внутренняя ошибка сервера |
Примечания:
- убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к репозиторию;
- метод удаляет только метаданные релиза и ассеты, но не сам Git-тег;
- после успешного удаления релиз становится недоступным для просмотра.