Удалить колонку проекта

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

Описание

Метод DELETE удаляет колонку с Kanban-доски указанного проекта. Операция необратима. Если в колонке есть задачи, поведение при удалении задается параметром task_action: задачи можно переместить в другую колонку или убрать из проекта. Метод применяется для приведения структуры проекта в порядок, когда этап рабочего процесса перестал использоваться.

⚠️ Важно: колонка удаляется безвозвратно. Если в ней есть задачи, заранее продумайте, куда их переместить (task_action=true + move_status_id) или согласуйте их удаление из проекта (task_action=false).

Токен

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

Заголовки

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

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

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

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

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

Параметр	Тип	Обязательный	Описание
task_action	boolean	Нет	Что сделать с задачами колонки при ее удалении: `true` — переместить задачи в другую колонку, `false` — убрать задачи из проекта. Параметр обязателен, если в колонке есть задачи
move_status_id	integer	Нет	Идентификатор целевой колонки, в которую переносятся задачи. Передается при `task_action=true`

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

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

curl -X DELETE "https://api.gitverse.ru/repos/myorg/backend-api/projects/42/columns/7?task_action=true&move_status_id=8" \
  -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

Особенности метода

Что происходит с задачами при удалении колонки? Задачи не удаляются. Если в колонке есть Задачи, поведение определяется параметром task_action:

task_action=true + move_status_id=<id колонки> — задачи переносятся в указанную целевую колонку;
task_action=false — задачи удаляются из проекта (сами задачи в репозитории сохраняются, привязка к проекту снимается). Можно ли переместить задачу в удаленную колонку? Нет. После удаления колонки запросы с project_status_id, указывающим на нее, завершаются ошибкой — колонка в проекте больше не существует. Удаление колонки не затрагивает сам проект и остальные колонки.

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

При успешном удалении тело ответа отсутствует. При ошибке сервер возвращает ответ в формате JSON. Заголовок Content-Type в ответе устанавливается в application/vnd.gitverse.object+json;version=latest.

Проводник