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