--- title: "Get a workflow run" method: GET path: "/repos/{owner}/{repo}/actions/runs/{run_id}" tags: ["actions"] --- # Get a workflow run `GET /repos/{owner}/{repo}/actions/runs/{run_id}` Gets a specific workflow run. Anyone with read access to the repository can use this endpoint. OAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint with a private repository. ## Path parameters - `owner` string, required - `repo` string, required - `run_id` integer, required ## Query parameters - `exclude_pull_requests` boolean ## Response `200` Response - WorkflowRun — An invocation of a workflow - `id` integer, required — The ID of the workflow run. - `name` string, nullable — The name of the workflow run. - `node_id` string, required - `check_suite_id` integer — The ID of the associated check suite. - `check_suite_node_id` string — The node ID of the associated check suite. - `head_branch` string, nullable, required - `head_sha` string, required — The SHA of the head commit that points to the version of the workflow being run. - `path` string, required — The full path of the workflow - `run_number` integer, required — The auto incrementing run number for the workflow run. - `run_attempt` integer — Attempt number of the run, 1 for first attempt and higher if the workflow was re-run. - `referenced_workflows` ReferencedWorkflow[], nullable - `path` string, required - `sha` string, required - `ref` string - `event` string, required - `status` string, nullable, required - `conclusion` string, nullable, required - `workflow_id` integer, required — The ID of the parent workflow. - `url` string, required — The URL to the workflow run. - `html_url` string, required - `pull_requests` PullRequestMinimal[], nullable, required — Pull requests that are open with a `head_sha` or `head_branch` that matches the workflow run. The returned pull requests do not necessarily indicate pull requests that triggered the run. - `id` integer, required - `number` integer, required - `url` string, required - `head` object, required - `ref` string, required - `sha` string, required - `repo` object, required - `id` integer, required - `url` string, required - `name` string, required - `base` object, required - `ref` string, required - `sha` string, required - `repo` object, required - `id` integer, required - `url` string, required - `name` string, required - `created_at` string, date-time, required - `updated_at` string, date-time, required - `actor` SimpleUser — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `triggering_actor` SimpleUser — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `run_started_at` string, date-time — The start time of the latest run. Resets on re-run. - `jobs_url` string, required — The URL to the jobs for the workflow run. - `logs_url` string, required — The URL to download the logs for the workflow run. - `check_suite_url` string, required — The URL to the associated check suite. - `artifacts_url` string, required — The URL to the artifacts for the workflow run. - `cancel_url` string, required — The URL to cancel the workflow run. - `rerun_url` string, required — The URL to rerun the workflow run. - `previous_attempt_url` string, nullable — The URL to the previous attempted run of this workflow, if one exists. - `workflow_url` string, required — The URL to the workflow. - `head_commit` NullableSimpleCommit, nullable, required — A commit. - `id` string, required — SHA for the commit - `tree_id` string, required — SHA for the commit's tree - `message` string, required — Message describing the purpose of the commit - `timestamp` string, date-time, required — Timestamp of the commit - `author` object, nullable, required — Information about the Git author - `name` string, required — Name of the commit's author - `email` string, email, required — Git email address of the commit's author - `committer` object, nullable, required — Information about the Git committer - `name` string, required — Name of the commit's committer - `email` string, email, required — Git email address of the commit's committer - `repository` MinimalRepository, required — Minimal Repository - `id` integer, required - `node_id` string, required - `name` string, required - `full_name` string, required - `owner` SimpleUser, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `private` boolean, required - `html_url` string, uri, required - `description` string, nullable, required - `fork` boolean, required - `url` string, uri, required - `archive_url` string, required - `assignees_url` string, required - `blobs_url` string, required - `branches_url` string, required - `collaborators_url` string, required - `comments_url` string, required - `commits_url` string, required - `compare_url` string, required - `contents_url` string, required - `contributors_url` string, uri, required - `deployments_url` string, uri, required - `downloads_url` string, uri, required - `events_url` string, uri, required - `forks_url` string, uri, required - `git_commits_url` string, required - `git_refs_url` string, required - `git_tags_url` string, required - `git_url` string - `issue_comment_url` string, required - `issue_events_url` string, required - `issues_url` string, required - `keys_url` string, required - `labels_url` string, required - `languages_url` string, uri, required - `merges_url` string, uri, required - `milestones_url` string, required - `notifications_url` string, required - `pulls_url` string, required - `releases_url` string, required - `ssh_url` string - `stargazers_url` string, uri, required - `statuses_url` string, required - `subscribers_url` string, uri, required - `subscription_url` string, uri, required - `tags_url` string, uri, required - `teams_url` string, uri, required - `trees_url` string, required - `clone_url` string - `mirror_url` string, nullable - `hooks_url` string, uri, required - `svn_url` string - `homepage` string, nullable - `language` string, nullable - `forks_count` integer - `stargazers_count` integer - `watchers_count` integer - `size` integer — The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0. - `default_branch` string - `open_issues_count` integer - `is_template` boolean - `topics` string[] - `has_issues` boolean - `has_projects` boolean - `has_wiki` boolean - `has_pages` boolean - `has_downloads` boolean - `has_discussions` boolean - `has_pull_requests` boolean - `pull_request_creation_policy` 'all' | 'collaborators_only' — The policy controlling who can create pull requests: all or collaborators_only. - `archived` boolean - `disabled` boolean - `visibility` string - `pushed_at` string, date-time, nullable - `created_at` string, date-time, nullable - `updated_at` string, date-time, nullable - `permissions` object - `admin` boolean - `maintain` boolean - `push` boolean - `triage` boolean - `pull` boolean - `role_name` string - `temp_clone_token` string - `delete_branch_on_merge` boolean - `subscribers_count` integer - `network_count` integer - `code_of_conduct` CodeOfConduct — Code Of Conduct - `key` string, required - `name` string, required - `url` string, uri, required - `body` string - `html_url` string, uri, nullable, required - `license` object, nullable - `key` string - `name` string - `spdx_id` string - `url` string, nullable - `node_id` string - `forks` integer - `open_issues` integer - `watchers` integer - `allow_forking` boolean - `web_commit_signoff_required` boolean - `security_and_analysis` SecurityAndAnalysis, nullable - `advanced_security` object — Enable or disable GitHub Advanced Security for the repository. For standalone Code Scanning or Secret Protection products, this parameter cannot be used. - `status` 'enabled' | 'disabled' - `code_security` object - `status` 'enabled' | 'disabled' - `dependabot_security_updates` object — Enable or disable Dependabot security updates for the repository. - `status` 'enabled' | 'disabled' — The enablement status of Dependabot security updates for the repository. - `secret_scanning` object - `status` 'enabled' | 'disabled' - `secret_scanning_push_protection` object - `status` 'enabled' | 'disabled' - `secret_scanning_non_provider_patterns` object - `status` 'enabled' | 'disabled' - `secret_scanning_ai_detection` object - `status` 'enabled' | 'disabled' - `secret_scanning_validity_checks` object - `status` 'enabled' | 'disabled' - `secret_scanning_delegated_alert_dismissal` object - `status` 'enabled' | 'disabled' - `secret_scanning_delegated_bypass` object - `status` 'enabled' | 'disabled' - `secret_scanning_delegated_bypass_options` object - `reviewers` object[] — The bypass reviewers for secret scanning delegated bypass - `reviewer_id` integer, required — The ID of the team or role selected as a bypass reviewer - `reviewer_type` 'TEAM' | 'ROLE', required — The type of the bypass reviewer - `mode` 'ALWAYS' | 'EXEMPT' — The bypass mode for the reviewer - `custom_properties` object — The custom properties that were defined for the repository. The keys are the custom property names, and the values are the corresponding custom property values. - `head_repository` MinimalRepository, required — Minimal Repository - `id` integer, required - `node_id` string, required - `name` string, required - `full_name` string, required - `owner` SimpleUser, required — A GitHub user. - `name` string, nullable - `email` string, nullable - `login` string, required - `id` integer, required - `node_id` string, required - `avatar_url` string, uri, required - `gravatar_id` string, nullable, required - `url` string, uri, required - `html_url` string, uri, required - `followers_url` string, uri, required - `following_url` string, required - `gists_url` string, required - `starred_url` string, required - `subscriptions_url` string, uri, required - `organizations_url` string, uri, required - `repos_url` string, uri, required - `events_url` string, required - `received_events_url` string, uri, required - `type` string, required - `site_admin` boolean, required - `starred_at` string - `user_view_type` string - `private` boolean, required - `html_url` string, uri, required - `description` string, nullable, required - `fork` boolean, required - `url` string, uri, required - `archive_url` string, required - `assignees_url` string, required - `blobs_url` string, required - `branches_url` string, required - `collaborators_url` string, required - `comments_url` string, required - `commits_url` string, required - `compare_url` string, required - `contents_url` string, required - `contributors_url` string, uri, required - `deployments_url` string, uri, required - `downloads_url` string, uri, required - `events_url` string, uri, required - `forks_url` string, uri, required - `git_commits_url` string, required - `git_refs_url` string, required - `git_tags_url` string, required - `git_url` string - `issue_comment_url` string, required - `issue_events_url` string, required - `issues_url` string, required - `keys_url` string, required - `labels_url` string, required - `languages_url` string, uri, required - `merges_url` string, uri, required - `milestones_url` string, required - `notifications_url` string, required - `pulls_url` string, required - `releases_url` string, required - `ssh_url` string - `stargazers_url` string, uri, required - `statuses_url` string, required - `subscribers_url` string, uri, required - `subscription_url` string, uri, required - `tags_url` string, uri, required - `teams_url` string, uri, required - `trees_url` string, required - `clone_url` string - `mirror_url` string, nullable - `hooks_url` string, uri, required - `svn_url` string - `homepage` string, nullable - `language` string, nullable - `forks_count` integer - `stargazers_count` integer - `watchers_count` integer - `size` integer — The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0. - `default_branch` string - `open_issues_count` integer - `is_template` boolean - `topics` string[] - `has_issues` boolean - `has_projects` boolean - `has_wiki` boolean - `has_pages` boolean - `has_downloads` boolean - `has_discussions` boolean - `has_pull_requests` boolean - `pull_request_creation_policy` 'all' | 'collaborators_only' — The policy controlling who can create pull requests: all or collaborators_only. - `archived` boolean - `disabled` boolean - `visibility` string - `pushed_at` string, date-time, nullable - `created_at` string, date-time, nullable - `updated_at` string, date-time, nullable - `permissions` object - `admin` boolean - `maintain` boolean - `push` boolean - `triage` boolean - `pull` boolean - `role_name` string - `temp_clone_token` string - `delete_branch_on_merge` boolean - `subscribers_count` integer - `network_count` integer - `code_of_conduct` CodeOfConduct — Code Of Conduct - `key` string, required - `name` string, required - `url` string, uri, required - `body` string - `html_url` string, uri, nullable, required - `license` object, nullable - `key` string - `name` string - `spdx_id` string - `url` string, nullable - `node_id` string - `forks` integer - `open_issues` integer - `watchers` integer - `allow_forking` boolean - `web_commit_signoff_required` boolean - `security_and_analysis` SecurityAndAnalysis, nullable - `advanced_security` object — Enable or disable GitHub Advanced Security for the repository. For standalone Code Scanning or Secret Protection products, this parameter cannot be used. - `status` 'enabled' | 'disabled' - `code_security` object - `status` 'enabled' | 'disabled' - `dependabot_security_updates` object — Enable or disable Dependabot security updates for the repository. - `status` 'enabled' | 'disabled' — The enablement status of Dependabot security updates for the repository. - `secret_scanning` object - `status` 'enabled' | 'disabled' - `secret_scanning_push_protection` object - `status` 'enabled' | 'disabled' - `secret_scanning_non_provider_patterns` object - `status` 'enabled' | 'disabled' - `secret_scanning_ai_detection` object - `status` 'enabled' | 'disabled' - `secret_scanning_validity_checks` object - `status` 'enabled' | 'disabled' - `secret_scanning_delegated_alert_dismissal` object - `status` 'enabled' | 'disabled' - `secret_scanning_delegated_bypass` object - `status` 'enabled' | 'disabled' - `secret_scanning_delegated_bypass_options` object - `reviewers` object[] — The bypass reviewers for secret scanning delegated bypass - `reviewer_id` integer, required — The ID of the team or role selected as a bypass reviewer - `reviewer_type` 'TEAM' | 'ROLE', required — The type of the bypass reviewer - `mode` 'ALWAYS' | 'EXEMPT' — The bypass mode for the reviewer - `custom_properties` object — The custom properties that were defined for the repository. The keys are the custom property names, and the values are the corresponding custom property values. - `head_repository_id` integer - `display_title` string, required — The event-specific title associated with the run or the run-name if set, or the value of `run-name` if it is set in the workflow. --- [API](https://skmtc.net/github/apis/github-v3-rest-api-3.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-3/versions/dc0584ac4e13/schema)