Перезапустить запуск воркфлоу

POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun

Описание

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

Токен

Требуется токен с правами на Запись для Репозитория.

Заголовки

ПараметрОбязательныйОписание
AuthorizationДаЗаголовок авторизации. Формат: Bearer <token>
AcceptНетТип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest

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

ПараметрОбязательныйОписание
ownerДаВладелец репозитория (логин или название организации)
repoДаНазвание репозитория
run_idДаИдентификатор запуска

Тело запроса

Данный метод не требует тела запроса.

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

curl -X POST "https://api.gitverse.ru/repos/myuser/myrepo/actions/runs/123456/rerun" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

Ответ (201 Created)

Метод не возвращает содержимого в ответе. Успешный перезапуск будет обозначаться статусом 201 Created.

Коды ответов

КодСтатусОписание
201CreatedЗапуск успешно перезапущен
400Bad RequestНекорректные параметры запроса
401UnauthorizedНеобходима авторизация
403ForbiddenНедостаточно прав на выполнение
404Not FoundРепозиторий или запуск не найдены
406Not AcceptableВоркфлоу отключен, перезапуск невозможен
409ConflictЗапуск еще выполняется, перезапустить его нельзя
429Too Many RequestsПревышен лимит запросов
500Internal Server ErrorВнутренняя ошибка сервера

Примечания

  • убедитесь, что токен API указан корректно и обладает необходимыми правами для доступа к репозиторию;
  • перезапустить можно только завершенный запуск, если запуск еще выполняется, метод вернет 409 Conflict;
  • если воркфлоу отключен, метод вернет 406 Not Acceptable.