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

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

Описание

Этот метод позволяет отменить выполнение запущенного воркфлоу по 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/cancel" \
  -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Репозиторий или запуск не найдены
409ConflictЗапуск уже завершил выполнение, отменить его нельзя
429Too Many RequestsПревышен лимит запросов
500Internal Server ErrorВнутренняя ошибка сервера

Примечания

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