Добавить элемент в проект репозитория
POST /repos/{owner}/{repo}/projects/{project_number}/items
Описание
Метод POST добавляет элемент в указанный проект репозитория. В GitVerse проект может содержать только задачи, поэтому тип добавляемого элемента — Issue.
Задача в теле запроса указывается либо идентификатором id, либо комбинацией owner/repo/number.
Метод применяется для размещения задач на Kanban-доске проекта при интеграции с внешними системами управления задачами.
⚠️ Важно: учитывается приватность репозитория и проекта. Если репозиторий или проект приватный, а запрос выполняется не владельцем, соавтором или участником команды с доступом к репозиторию, возвращается ошибка 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 | Да | Номер проекта |
Тело запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| type | string | Нет | Тип элемента: Issue (задача) или PullRequest (сейчас не поддерживается) |
| id | integer | Нет | Уникальный идентификатор задачи. Можно не отправлять, если переданы owner, repo и number |
| owner | string | Нет | Владелец репозитория задачи. Можно не отправлять, если передан id |
| repo | string | Нет | Название репозитория задачи. Можно не отправлять, если передан id |
| number | integer | Нет | Номер задачи в репозитории. Можно не отправлять, если передан id |
Пример тела запроса
{
"type": "Issue",
"owner": "myorg",
"repo": "backend-api",
"number": 156
}Пример запроса
Ниже приведен пример использования curl для добавления задачи с номером 156 в проект с номером 1.
curl -X POST "https://api.gitverse.ru/repos/myorg/backend-api/projects/1/items" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "Accept: application/vnd.gitverse.object+json;version=latest" \
-H "Content-Type: application/json" \
-d '{
"type": "Issue",
"owner": "myorg",
"repo": "backend-api",
"number": 156
}'Замените <YOUR-TOKEN> на ваш личный токен доступа.
Ответ при успешном выполнении (201 Created)
При успешном добавлении сервер вернет ответ с кодом 201 Created и телом в формате JSON, содержащим объект добавленного элемента проекта:
{
"id": 5,
"node_id": null,
"project_url": "/repos/myorg/backend-api/projects/1",
"content": {
"id": 163200,
"number": 156,
"title": "Добавить пагинацию в список проектов",
"state": "open",
"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/5",
"fields": [
{
"name": "Status",
"value": {
"id": "7",
"name": {
"raw": "To Do"
},
"color": "BLUE"
}
}
]
}Структура ответа
Ответ — объект 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 | Поля элемента проекта. Сейчас содержит только одно поле — статус (колонку, в которой находится задача) |
Структура объекта fields (поле Status):
| Поле | Тип | Описание |
|---|---|---|
name | string | Название поля. Сейчас всегда Status |
value.id | string | Идентификатор колонки (строкой) |
value.name.raw | string | Название колонки (например, To Do) |
value.color | string | Цвет колонки (например, BLUE) |
Примечание: поле
creator(пользователь, добавивший элемент в проект) в ответах GitVerse не возвращается.
Коды ответа
Результат выполнения запроса определяется по HTTP-статусу:
| Код | Статус | Описание |
|---|---|---|
| 201 | Created | Элемент успешно добавлен в проект |
| 400 | Bad Request | Некорректные параметры запроса |
| 401 | Unauthorized | Не передан или невалиден токен авторизации |
| 403 | Forbidden | Недостаточно прав на запись в репозиторий |
| 404 | Not Found | Ресурс не найден либо нет доступа к нему |
| 422 | Unprocessable Entity | Ошибка валидации |
| 500 | Internal Server Error | Внутренняя ошибка сервера GitVerse |
Пример ответа с ошибкой
Пример некорректного запроса: в теле запроса не передан ни идентификатор задачи id, ни комбинация owner/repo/number.
{
"type": "Issue"
}Сервер вернет ответ 400 Bad Request:
{
"message": "Bad Request",
"documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}Прочие коды ошибки возвращают ответ той же структуры, например 404 Not Found:
{
"message": "Not Found",
"documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}Особенности метода
- в проект добавляются только задачи: значение
PullRequestв полеtypeсейчас не поддерживается; - задача может быть указана либо идентификатором
id, либо комбинациейowner/repo/number; - колонка, в которой размещена задача, указана в поле
Statusответа (fields). Чтобы переместить задачу в другую колонку, используйте методPATCH /repos/{owner}/{repo}/projects/{project_number}/items/{item_id}; - одновременно задача может принадлежать только одному проекту. Если задача уже находится в другом проекте, она перемещается в указанный проект.
Формат ответа и заголовки
Метод возвращает ответ в формате JSON. Заголовок Content-Type в ответе устанавливается в application/vnd.gitverse.object+json;version=latest.