runs

Overview

Name	runs
Type	Resource
Id	github.checks.runs

Fields

Name	Datatype	Description
id	integer	The id of the check.
name	string	The name of the check.
status	string	The phase of the lifecycle that the check is currently in.
deployment	object	A deployment created as the result of an Actions check run from a workflow that references an environment
html_url	string
app	object	GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.
external_id	string
head_sha	string	The SHA of the commit that is being checked.
pull_requests	array
details_url	string
url	string
conclusion	string
check_suite	object
output	object
node_id	string
completed_at	string
started_at	string

Methods

Name	Accessible by	Required Params	Description
get	SELECT	check_run_id, owner, repo	Note: The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull_requests array. Gets a single check run using its id. GitHub Apps must have the checks:read permission on a private repository or pull access to a public repository to get check runs. OAuth Apps and authenticated users must have the repo scope to get check runs in a private repository.
list_for_ref	SELECT	owner, ref, repo	Note: The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull_requests array. Lists check runs for a commit ref. The ref can be a SHA, branch name, or a tag name. GitHub Apps must have the checks:read permission on a private repository or pull access to a public repository to get check runs. OAuth Apps and authenticated users must have the repo scope to get check runs in a private repository.
list_for_suite	SELECT	check_suite_id, owner, repo	Note: The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull_requests array. Lists check runs for a check suite using its id. GitHub Apps must have the checks:read permission on a private repository or pull access to a public repository to get check runs. OAuth Apps and authenticated users must have the repo scope to get check runs in a private repository.
create	INSERT	owner, repo, data__head_sha, data__name	Note: The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull_requests array. Creates a new check run for a specific commit in a repository. Your GitHub App must have the checks:write permission to create check runs. In a check suite, GitHub limits the number of check runs with the same name to 1000. Once these check runs exceed 1000, GitHub will start to automatically delete older check runs.
rerequest_run	EXEC	check_run_id, owner, repo	Triggers GitHub to rerequest an existing check run, without pushing new code to a repository. This endpoint will trigger the check_run webhook event with the action rerequested. When a check run is rerequested, its status is reset to queued and the conclusion is cleared. To rerequest a check run, your GitHub App must have the checks:read permission on a private repository or pull access to a public repository.
update	EXEC	check_run_id, owner, repo	Note: The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull_requests array. Updates a check run for a specific commit in a repository. Your GitHub App must have the checks:write permission to edit check runs.