Удалить веху репозитория
DELETE /repos/{owner}/{repo}/milestones/{id}
Описание
Метод DELETE удаляет веху из указанного репозитория по ее идентификатору. Операция необратима: веха удаляется вместе с ее данными, привязанные к ней задачи не удаляются — только отвязываются от вехи.
Метод применяется для очистки устаревших или неактуальных вех, завершения планирования и синхронизации состояния вех с внешними системами управления задачами.
⚠️ Важно: после успешного выполнения запроса восстановление вехи невозможно.
Токен
Требуется токен с правами на Запись для Репозитория.
Заголовки
| Параметр | Обязательный | Описание |
|---|---|---|
| Accept | Нет | Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest |
| Authorization | Да | Токен доступа. Формат: Bearer <YOUR-TOKEN> или token <YOUR-TOKEN> |
Параметры пути
В URL запроса необходимо передать следующие идентификаторы ресурса:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| owner | string | Да | Владелец репозитория (логин пользователя или имя организации) |
| repo | string | Да | Название репозитория (без расширения .git) |
| id | integer | Да | Уникальный идентификатор вехи |
Параметры и тело запроса
Данный метод не принимает параметров строки запроса и не требует тела запроса.
Пример запроса
Ниже приведен пример использования curl для удаления вехи с идентификатором 1.
curl -X DELETE "https://api.gitverse.ru/repos/myorg/backend-api/milestones/1" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "Accept: application/vnd.gitverse.object+json;version=latest"Замените YOUR_TOKEN на ваш личный токен доступа.
Ответ при успешном выполнении (204 No Content)
При успешном удалении вехи сервер вернет ответ с кодом 204 No Content без тела ответа.
Структура ответа
Ответ отсутствует (пустое тело).
Коды ответа
Результат выполнения запроса определяется по HTTP-статусу:
| Код | Статус | Описание |
|---|---|---|
| 204 | No Content | Веха успешно удалена |
| 401 | Unauthorized | Не передан или невалиден токен авторизации |
| 403 | Forbidden | Нет прав на запись в репозиторий |
| 404 | Not Found | Репозиторий или веха не найдены |
| 500 | Internal Server Error | Внутренняя ошибка сервера GitVerse |
Формат ответа и заголовки
При успешном удалении тело ответа отсутствует. При ошибке сервер возвращает ответ в формате JSON. Заголовок Content-Type в ответе устанавливается в application/vnd.gitverse.object+json;version=latest.