Удалить файл из задачи
DELETE /repos/{owner}/{repo}/issues/{issue_number}/attachments/{attachment_id}
Описание
Метод DELETE удаляет файл, прикрепленный к существующей задаче. Метод не применяется к запросам на слияние.
Метод применяется для удаления ошибочно загруженных или устаревших вложений задачи.
Права доступа: удалить файл может автор задачи, пользователь с правом записи в репозиторий, администратор репозитория или администратор инстанса.
Заголовки
| Параметр | Обязательный | Описание |
|---|---|---|
Accept | Нет | Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=1 |
Authorization | Да | Токен доступа. Формат: Bearer <YOUR-TOKEN> или token <YOUR-TOKEN> |
Параметры пути
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
owner | string | Да | Владелец репозитория (логин пользователя или имя организации) |
repo | string | Да | Название репозитория (без расширения .git) |
issue_number | integer | Да | Номер задачи |
attachment_id | integer | Да | Идентификатор вложения |
Параметры и тело запроса
Данный метод не принимает параметров строки запроса и не требует тела запроса.
Пример запроса
curl -X DELETE "https://api.gitverse.ru/repos/user/my-repo/issues/18/attachments/55" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1"
Замените YOUR_TOKEN на ваш личный токен доступа.
Пример ответа (200 OK)
При успешном выполнении сервер возвращает массив оставшихся вложений задачи; если файлов больше нет, ответ — []:
[
{
"id": 56,
"uuid": "a1b2c3d4-...",
"name": "config.json",
"size": 512,
"browser_download_url": "https://gitverse.ru/user/repo/attachments/a1b2c3d4-...",
"created_at": "2025-06-10T09:05:00Z"
}
]
Структура ответа
Ответ — массив объектов Attachment (вложения). Полная структура описана в графе объектов, раздел «Объект Attachment».
На корневом уровне каждый элемент содержит:
| Поле | Тип | Описание |
|---|---|---|
id | integer | Идентификатор вложения |
name | string | Имя файла |
size | integer | Размер в байтах |
created_at | string (date-time) | Дата загрузки |
uuid | string | Уникальный идентификатор файла |
browser_download_url | string | Прямая ссылка на скачивание |
Коды ответа
| Код | Статус | Описание |
|---|---|---|
200 | OK | Файл удален, список обновлен. |
403 | Forbidden | Нет прав на доступ к репозиторию. |
404 | Not Found | Файл, задача или репозиторий не найдены. |
422 | Unprocessable Entity | Ошибка валидации данных. |
500 | Internal Server Error | Внутренняя ошибка сервера GitVerse. |
Особенности метода
Для несуществующего или не принадлежащего задаче файла API возвращает 404 Not Found.