Удалить файл из задачи

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.

Пример тела ошибки

При ответе 403 тело ответа имеет следующий вид:

{
  "error": {
    "code": "FORBIDDEN",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "Access denied",
    "status": 403
  }
}

Особенности метода

Для несуществующего или не принадлежащего задаче файла API возвращает 404 Not Found.

Проводник