Получение списка запусков воркфлоу

GET /repos/{owner}/{repo}/actions/workflows/{workflow}/runs

Описание

Этот метод позволяет получить перечень всех запусков конкретного воркфлоу в репозитории. Результаты можно фильтровать по актору, ветке, событию и статусу.

Токен

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

Параметры URL:

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

Параметры запроса:

Параметр	Обязательный	Описание
actor	Нет	Имя пользователя, инициировавшего запуск
branch	Нет	Имя ветки, для которой были выполнены запуски
event	Нет	Событие, которое инициировало запуск воркфлоу
status	Нет	Статус запуска воркфлоу
page	Нет	Номер страницы (начиная с 1)
per_page	Нет	Количество результатов на странице

Тело запроса:

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

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

curl -X GET "https://api.gitverse.ru/repos/myuser/myrepo/actions/workflows/ci.yaml/runs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=latest" \
  -G \
  --data-urlencode "branch=main" \
  --data-urlencode "status=success" \
  --data-urlencode "per_page=20"

Ответ (200 OK):

Ответ содержит список запусков указанного воркфлоу.

{
  "total_count": 2,
  "workflow_runs": [
    {
      "id": 98765,
      "index": 42,
      "name": "CI",
      "status": "completed",
      "event": "push",
      "commit_sha": "abc123def456",
      "ref": "refs/heads/main",
      "title": "Push to main",
      "started": "2025-07-01T12:00:00Z",
      "stopped": "2025-07-01T12:05:00Z",
      "need_approval": false,
      "approved_by": 0,
      "is_fork_pull_request": false,
      "actor": {
        "id": 1001,
        "login": "myuser",
        "avatar_url": "https://api.gitverse.ru/myuser/avatar",
        "html_url": "https://gitverse.ru/myuser",
        "type": "User",
        "site_admin": false,
        "url": "https://api.gitverse.ru/users/myuser",
        "followers_url": "https://api.gitverse.ru/users/myuser/followers",
        "following_url": "https://api.gitverse.ru/users/myuser/following",
        "repos_url": "https://api.gitverse.ru/users/myuser/repos",
        "organizations_url": "https://api.gitverse.ru/users/myuser/orgs"
      }
    },
    {
      "id": 98764,
      "index": 41,
      "name": "CI",
      "status": "completed",
      "event": "push",
      "commit_sha": "def789ghi012",
      "ref": "refs/heads/main",
      "title": "Push to main",
      "started": "2025-06-30T10:00:00Z",
      "stopped": "2025-06-30T10:03:00Z",
      "need_approval": false,
      "approved_by": 0,
      "is_fork_pull_request": false,
      "actor": {
        "id": 1001,
        "login": "myuser",
        "avatar_url": "https://api.gitverse.ru/myuser/avatar",
        "html_url": "https://gitverse.ru/myuser",
        "type": "User",
        "site_admin": false,
        "url": "https://api.gitverse.ru/users/myuser",
        "followers_url": "https://api.gitverse.ru/users/myuser/followers",
        "following_url": "https://api.gitverse.ru/users/myuser/following",
        "repos_url": "https://api.gitverse.ru/users/myuser/repos",
        "organizations_url": "https://api.gitverse.ru/users/myuser/orgs"
      }
    }
  ]
}

Формат ответа: application/vnd.gitverse.object+json;version=latest

Коды ответов

Код	Статус	Описание
200	Ok	Запрос выполнен успешно, список запусков получен
401	Unauthorized	Необходима авторизация
403	Forbidden	Недостаточно прав для доступа к репозиторию
404	Not Found	Репозиторий или воркфлоу не найден
500	Internal Server Error	Внутренняя ошибка сервера

Примечания:

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