Удалить проект репозитория

DELETE /repos/{owner}/{repo}/projects/{project_id}

Описание

Метод DELETE удаляет проект из указанного репозитория по его идентификатору. Операция необратима: вместе с проектом удаляются все связанные с ним колонки и привязки задач к колонкам проекта (сами задачи при этом не удаляются). Метод применяется для очистки устаревших или неактуальных проектов, завершения рабочих процессов и синхронизации состояния проектов с внешними системами управления задачами.

⚠️ Важно: после успешного выполнения запроса восстановление проекта невозможно.

Токен

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

Заголовки

Параметр	Обязательный	Описание
Accept	Нет	Тип содержимого ответа. Рекомендуется установить значение `application/vnd.gitverse.object+json;version=latest`
Authorization	Да	Токен доступа. Формат: `Bearer <YOUR-TOKEN>` или `token <YOUR-TOKEN>`

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

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

Параметр	Тип	Обязательный	Описание
owner	string	Да	Владелец репозитория (логин пользователя или имя организации)
repo	string	Да	Название репозитория (без расширения `.git`)
project_id	integer	Да	Уникальный идентификатор проекта

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

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

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

Ниже приведен пример использования curl для удаления проекта с идентификатором 42.

curl -X DELETE "https://api.gitverse.ru/repos/myorg/backend-api/projects/42" \
  -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.

Проводник