Удалить элемент проекта репозитория
DELETE /repos/{owner}/{repo}/projects/{project_number}/items/{item_id}
Описание
Метод DELETE удаляет указанный элемент из проекта репозитория. При выполнении запроса задача удаляется из проекта, но сама задача не удаляется — она остается в репозитории и продолжает быть доступной.
Метод применяется для снятия задач с Kanban-доски проекта при интеграции с внешними системами управления задачами.
⚠️ Важно: учитывается приватность репозитория и проекта. Если репозиторий или проект приватный, а запрос выполняется не владельцем, соавтором или участником команды с доступом к репозиторию, возвращается ошибка 404.
Токен
Требуется токен с правами на Запись для Репозитория.
Заголовки
| Параметр | Обязательный | Описание |
|---|---|---|
| Accept | Нет | Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest |
| Authorization | Да | Токен доступа. Формат: Bearer <YOUR-TOKEN> или token <YOUR-TOKEN> |
Параметры пути
В URL запроса необходимо передать следующие идентификаторы ресурса:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| owner | string | Да | Владелец репозитория (логин пользователя или имя организации) |
| repo | string | Да | Название репозитория (без расширения .git) |
| project_number | integer | Да | Номер проекта |
| item_id | integer | Да | Идентификатор элемента проекта |
Параметры и тело запроса
Данный метод не принимает параметров строки запроса и не требует тела запроса.
Пример запроса
Ниже приведен пример использования curl для удаления элемента с идентификатором 3 проекта с номером 1.
curl -X DELETE "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"Замените <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": "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/3",
"fields": [
{
"name": "Status",
"value": {
"id": "8",
"name": {
"raw": "In progress"
},
"color": "YELLOW"
}
}
]
}Структура ответа
Ответ — объект 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 | Название колонки (например, In progress) |
value.color | string | Цвет колонки (например, YELLOW) |
Примечание: поле
creator(пользователь, добавивший элемент в проект) в ответах GitVerse не возвращается.
Коды ответа
Результат выполнения запроса определяется по HTTP-статусу:
| Код | Статус | Описание |
|---|---|---|
| 200 | OK | Элемент успешно удален из проекта |
| 401 | Unauthorized | Не передан или невалиден токен авторизации |
| 403 | Forbidden | Недостаточно прав на запись в репозиторий |
| 404 | Not Found | Ресурс не найден либо нет доступа к нему |
| 500 | Internal Server Error | Внутренняя ошибка сервера GitVerse |
Пример ответа с ошибкой
Пример: элемент с идентификатором 999 в проекте не существует. Сервер вернет ответ 404 Not Found:
{
"message": "Not Found",
"documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}Прочие коды ошибки возвращают ответ той же структуры, например 401 Unauthorized:
{
"message": "Unauthorized",
"documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}Особенности метода
- удаление элемента из проекта не удаляет саму задачу: она остается в репозитории и продолжает быть доступной по обычным методам работы с задачами;
- чтобы вернуть задачу в проект, используйте метод
POST /repos/{owner}/{repo}/projects/{project_number}/items.
Формат ответа и заголовки
Метод возвращает ответ в формате JSON. Заголовок Content-Type в ответе устанавливается в application/vnd.gitverse.object+json;version=latest.