Прикрепить файл к задаче

POST /repos/{owner}/{repo}/issues/{issue_number}/attachments

Описание

Метод POST загружает файл и прикрепляет его к существующей задаче. Метод не применяется к запросам на слияние.

Файл передается в теле запроса в формате multipart/form-data в поле attachment.

Метод применяется для прикрепления к задаче скриншотов, логов, примеров и других вспомогательных файлов.

Права доступа: загрузить файл может автор задачи, администратор репозитория или администратор инстанса.

Заголовки

Параметр	Обязательный	Описание
`Accept`	Нет	Тип содержимого ответа. Рекомендуется установить значение `application/vnd.gitverse.object+json;version=1`
`Authorization`	Да	Токен доступа. Формат: `Bearer <YOUR-TOKEN>` или `token <YOUR-TOKEN>`
`Content-Type`	Да	Тип содержимого запроса: `multipart/form-data`

Параметры пути

Параметр	Тип	Обязательный	Описание
`owner`	string	Да	Владелец репозитория (логин пользователя или имя организации)
`repo`	string	Да	Название репозитория (без расширения `.git`)
`issue_number`	integer	Да	Номер задачи

Параметры запроса

Параметр	Тип	Обязательный	Описание
`attachment`	file	Да	Прикрепляемый файл

Тело запроса

Данный метод принимает файл в формате multipart/form-data. Параметры тела отсутствуют.

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

curl -X POST "https://api.gitverse.ru/repos/user/my-repo/issues/18/attachments" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1" \
  -H "Content-Type: multipart/form-data" \
  -F "attachment=@/path/to/error.log"

Замените YOUR_TOKEN на ваш личный токен доступа.

Пример ответа (`201 Created`)

При успешном выполнении сервер возвращает массив вложений задачи:

[
  {
    "id": 55,
    "uuid": "c2f6418f-...",
    "name": "error.log",
    "size": 4096,
    "browser_download_url": "https://gitverse.ru/user/repo/attachments/c2f6418f-...",
    "created_at": "2025-06-10T09:00:00Z"
  }
]

Коды ответа

Код	Статус	Описание
`201`	`Created`	Файл успешно загружен.
`400`	`Bad Request`	Некорректные параметры запроса.
`403`	`Forbidden`	Нет прав на доступ к репозиторию.
`404`	`Not Found`	Задача или репозиторий не найдены.
`422`	`Unprocessable Entity`	Ошибка валидации данных.
`500`	`Internal Server Error`	Внутренняя ошибка сервера GitVerse.

Проводник