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

POST /repos/{owner}/{repo}/actions/jobs/{job_id}/rerun

Описание

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

Токен

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

Заголовки

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

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

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

Тело запроса

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

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

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

Ответ (`201 Created`)

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

Коды ответов

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

Примечания

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

Проводник