Обновить элемент проекта репозитория
PATCH /repos/{owner}/{repo}/projects/{project_number}/items/{item_id}
Описание
Метод PATCH обновляет указанный элемент проекта репозитория. Сейчас поддерживается одно обновление — перемещение задачи в другую колонку проекта: в теле запроса передается status_id (идентификатор целевой колонки).
Сама задача не изменяется: меняется только ее положение на Kanban-доске проекта (статус, поле Status в fields).
Метод применяется для перемещения задач между этапами рабочего процесса при интеграции с внешними системами управления задачами.
⚠️ Важно: учитывается приватность репозитория и проекта. Если репозиторий или проект приватный, а запрос выполняется не владельцем, соавтором или участником команды с доступом к репозиторию, возвращается ошибка 404.
Токен
Требуется токен с правами на Запись для Репозитория.
Заголовки
| Параметр | Обязательный | Описание |
|---|---|---|
| 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_number | integer | Да | Номер проекта |
| item_id | integer | Да | Идентификатор элемента проекта |
Тело запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| status_id | integer | Да | Идентификатор колонки проекта, в которую нужно поместить задачу |
Пример тела запроса
{
"status_id": 9
}Пример запроса
Ниже приведен пример использования curl для перемещения элемента с идентификатором 3 проекта с номером 1 в колонку с идентификатором 9 («Done»).
curl -X PATCH "https://api.gitverse.ru/repos/myorg/backend-api/projects/1/items/3" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "Accept: application/vnd.gitverse.object+json;version=latest" \
-H "Content-Type: application/json" \
-d '{
"status_id": 9
}'Замените <YOUR-TOKEN> на ваш личный токен доступа.
Ответ при успешном выполнении (200 OK)
При успешном обновлении сервер вернет ответ с кодом 200 OK и телом в формате JSON, содержащим обновленный объект элемента проекта:
{
"id": 3,
"node_id": null,
"project_url": "/repos/myorg/backend-api/projects/1",
"content": {
"id": 163200,
"number": 156,
"title": "Добавить пагинацию в список проектов",
"state": "closed",
"user": {
"id": 516,
"login": "user123"
},
"assignee": null,
"labels": [],
"created_at": "2026-09-14T10:00:00Z",
"updated_at": "2026-09-17T11:05:00Z",
"html_url": "https://gitverse.ru/myorg/backend-api/issues/156"
},
"content_type": "Issue",
"created_at": null,
"updated_at": null,
"archived_at": null,
"item_url": "/repos/myorg/backend-api/projects/1/items/3",
"fields": [
{
"name": "Status",
"value": {
"id": "9",
"name": {
"raw": "Done"
},
"color": "PURPLE"
}
}
]
}Структура ответа
Ответ — объект ProjectItem (обновленный элемент проекта). Он содержит:
| Поле | Тип | Описание |
|---|---|---|
id | integer | Уникальный идентификатор элемента проекта |
node_id | string | Глобальный ID узла (GraphQL). В ответах GitVerse всегда null |
project_url | string | API URL для доступа к проекту |
content | object | Объект, которым является элемент проекта. В GitVerse всегда задача — см. граф объектов, раздел «Объект Issue» |
content_type | string | Тип контента элемента. В GitVerse всегда Issue |
created_at | string / null | Время создания элемента. В ответах GitVerse всегда null |
updated_at | string / null | Время обновления элемента. В ответах GitVerse всегда null |
archived_at | string / null | Время архивирования элемента. В ответах GitVerse всегда null |
item_url | string | API URL для доступа к элементу проекта |
fields | array | Поля элемента проекта. После обновления поле Status отражает новую колонку задачи |
Структура объекта fields (поле Status):
| Поле | Тип | Описание |
|---|---|---|
name | string | Название поля. Сейчас всегда Status |
value.id | string | Идентификатор колонки (строкой) |
value.name.raw | string | Название колонки (например, Done) |
value.color | string | Цвет колонки (например, PURPLE) |
Примечание: поле
creator(пользователь, добавивший элемент в проект) в ответах GitVerse не возвращается.
Коды ответа
Результат выполнения запроса определяется по HTTP-статусу:
| Код | Статус | Описание |
|---|---|---|
| 200 | OK | Элемент успешно обновлен |
| 400 | Bad Request | Некорректные параметры запроса |
| 401 | Unauthorized | Не передан или невалиден токен авторизации |
| 403 | Forbidden | Недостаточно прав на запись в репозиторий |
| 404 | Not Found | Ресурс не найден либо нет доступа к нему |
| 500 | Internal Server Error | Внутренняя ошибка сервера GitVerse |
Пример ответа с ошибкой
Пример некорректного запроса: status_id указывает на несуществующую колонку.
{
"status_id": 999
}Сервер вернет ответ 404 Not Found:
{
"message": "Not Found",
"documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}Прочие коды ошибки возвращают ответ той же структуры, например 400 Bad Request:
{
"message": "Bad Request",
"documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}Особенности метода
status_idдолжен указывать на существующую колонку данного проекта: колонку из другого проекта передать нельзя;- перемещение задачи в колонку не изменяет ее номер (
number) и остальные поля задачи; - альтернативный способ переместить задачу в колонку — метод
PATCH /repos/{owner}/{repo}/issues/{index}с полямиproject_id/project_status_id; - чтобы убрать задачу из проекта, используйте метод
DELETE /repos/{owner}/{repo}/projects/{project_number}/items/{item_id}.
Формат ответа и заголовки
Метод возвращает ответ в формате JSON. Заголовок Content-Type в ответе устанавливается в application/vnd.gitverse.object+json;version=latest.