2. POST /repos/{owner}/{repo}/actions/workflows/{workflow}/dispatches — запустить поток вручную
Описание
Запускает указанный поток вручную в репозитории.
Параметры URL:
| Параметр | Обязательный | Описание |
|---|
owner | Да | Владелец репозитория (логин или название организации) |
repo | Да | Название репозитория |
workflow | Да | Идентификатор потока |
Параметры запроса:
| Параметр | Обязательный | Описание |
|---|
branch | Нет | Название ветки для запуска потока |
tag | Нет | Название тега для запуска потока |
Тело запроса:
{
"inputKey1": "value1",
"inputKey2": "value2"
}
| Поле | Обязательный | Описание |
|---|
inputKey1 | Нет | Название входного параметра и его значение |
Пример запроса:
curl -X POST https://api.gitverse.ru/repos/user/APInewTestRepo4.3/actions/workflows/ci.yaml/dispatches?branch=main \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1" \
-H "Content-Type: application/json" \
-data-raw '{
"logLevel": "warning",
"tags": "external"
}'
Ответ (204 No Content):
Данный метод не возвращает содержимого в ответе. Успешный запуск потока будет обозначаться статусом 204 No Content.
Коды ответов
| Код | Статус | Описание |
|---|
204 | No Content | Успешный запуск потока, без содержимого в ответе |
400 | Bad Request | Неверный формат запроса или недопустимые данные в теле запроса |
401 | Unauthorized | Необходима авторизация |
403 | Forbidden | У вас нет прав для запуска потока |
404 | Not Found | Указанный репозиторий или рабочий процесс не найдены |
406 | Not Acceptable | Тип контента не поддерживается |
429 | Too Many Requests | Превышен лимит запросов |
500 | Internal Server Error | Внутренняя ошибка сервера |
Примечания:
- убедитесь, что вы используете правильный токен авторизации с необходимыми правами доступа к репозиторию;
- проверьте наличие потока по указанному идентификатору.