Обновить элемент проекта репозитория

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 запроса необходимо передать следующие идентификаторы ресурса:

ПараметрТипОбязательныйОписание
ownerstringДаВладелец репозитория (логин пользователя или имя организации)
repostringДаНазвание репозитория (без расширения .git)
project_numberintegerДаНомер проекта
item_idintegerДаИдентификатор элемента проекта

Тело запроса

ПараметрТипОбязательныйОписание
status_idintegerДаИдентификатор колонки проекта, в которую нужно поместить задачу

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

{
  "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 (обновленный элемент проекта). Он содержит:

ПолеТипОписание
idintegerУникальный идентификатор элемента проекта
node_idstringГлобальный ID узла (GraphQL). В ответах GitVerse всегда null
project_urlstringAPI URL для доступа к проекту
contentobjectОбъект, которым является элемент проекта. В GitVerse всегда задача — см. граф объектов, раздел «Объект Issue»
content_typestringТип контента элемента. В GitVerse всегда Issue
created_atstring / nullВремя создания элемента. В ответах GitVerse всегда null
updated_atstring / nullВремя обновления элемента. В ответах GitVerse всегда null
archived_atstring / nullВремя архивирования элемента. В ответах GitVerse всегда null
item_urlstringAPI URL для доступа к элементу проекта
fieldsarrayПоля элемента проекта. После обновления поле Status отражает новую колонку задачи

Структура объекта fields (поле Status):

ПолеТипОписание
namestringНазвание поля. Сейчас всегда Status
value.idstringИдентификатор колонки (строкой)
value.name.rawstringНазвание колонки (например, Done)
value.colorstringЦвет колонки (например, PURPLE)

Примечание: поле creator (пользователь, добавивший элемент в проект) в ответах GitVerse не возвращается.

Коды ответа

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

КодСтатусОписание
200OKЭлемент успешно обновлен
400Bad RequestНекорректные параметры запроса
401UnauthorizedНе передан или невалиден токен авторизации
403ForbiddenНедостаточно прав на запись в репозиторий
404Not FoundРесурс не найден либо нет доступа к нему
500Internal 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.