Обновить колонку проекта

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

Описание

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

Токен

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

Заголовки

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

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

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

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

Тело запроса

Параметр	Тип	Обязательный	Описание
title	string	Нет	Новое название колонки
color	string	Нет	Новый цвет колонки в HEX-формате (например, `#E3B341`)
default	boolean	Нет	Сделать колонку колонкой по умолчанию (`true`/`false`)
sorting	integer	Нет	Новая позиция колонки на доске. Колонки, начиная с указанной позиции, сдвигаются

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

{
  "title": "Backlog",
  "color": "#6E7191"
}

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

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

curl -X PATCH "https://api.gitverse.ru/repos/myorg/backend-api/projects/42/columns/7" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=latest" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Backlog",
    "color": "#6E7191"
  }'

Замените YOUR_TOKEN на ваш личный токен доступа.

Ответ при успешном выполнении (200 OK)

При успешном обновлении сервер вернет ответ с кодом 200 OK и телом в формате JSON, содержащим обновленный объект колонки:

{
  "id": 7,
  "title": "Backlog",
  "color": "#6E7191",
  "default": true,
  "sorting": 1,
  "created_at": "2026-09-14T10:00:00Z",
  "updated_at": "2026-09-17T09:35:00Z"
}

Структура ответа

Ответ — объект ProjectColumn (обновленная колонка). Полная структура описана в графе объектов, раздел «Объект ProjectColumn».

На корневом уровне объект содержит:

Поле	Тип	Описание
`id`	integer	Уникальный идентификатор колонки
`title`	string	Название колонки
`color`	string	Цвет колонки в формате HEX (например, `#0969DA`)
`default`	boolean	Является ли колонка колонкой по умолчанию
`sorting`	integer	Порядковый номер колонки для сортировки
`created_at`	string (date-time)	Дата создания колонки
`updated_at`	string (date-time)	Дата последнего обновления колонки

Коды ответа

Результат выполнения запроса определяется по HTTP-статусу:

Код	Статус	Описание
200	OK	Колонка успешно обновлена
400	Bad Request	Некорректное тело запроса (некорректный JSON или пустое тело)
401	Unauthorized	Не передан или невалиден токен авторизации
403	Forbidden	Нет прав на запись в репозиторий
404	Not Found	Репозиторий, проект или колонка не найдены
500	Internal Server Error	Внутренняя ошибка сервера GitVerse

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

частичное обновление: поля, не переданные в теле запроса, не изменяются;
при передаче sorting колонка перемещается на новую позицию, значения sorting остальных колонок корректируются соответствующим образом;
переименование колонки не влияет на задачи в ней: связь задач с колонкой сохраняется по идентификатору колонки, а не по ее названию.

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

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

Проводник