View Source GitHub.Checks (GitHub REST API Client v0.3.3)
Provides API endpoints related to checks
Link to this section Summary
Functions
Create a check run
Create a check suite
Get a check run
Get a check suite
List check run annotations
List check runs for a Git reference
List check runs in a check suite
List check suites for a Git reference
Rerequest a check run
Rerequest a check suite
Update repository preferences for check suites
Update a check run
Link to this section Types
@type list_for_ref_200_json_resp() :: %{ __info__: map(), check_runs: [GitHub.Check.Run.t()], total_count: integer() }
@type list_for_suite_200_json_resp() :: %{ __info__: map(), check_runs: [GitHub.Check.Run.t()], total_count: integer() }
@type list_suites_for_ref_200_json_resp() :: %{ __info__: map(), check_suites: [GitHub.Check.Suite.t()], total_count: integer() }
Link to this section Functions
@spec create(String.t(), String.t(), map(), keyword()) :: {:ok, GitHub.Check.Run.t()} | {:error, GitHub.Error.t()}
Create a check run
Creates a new check run for a specific commit in a repository.
To create a check run, you must use a GitHub App. OAuth apps and authenticated users are not able to create a check suite.
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.
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.
resources
Resources
@spec create_suite(String.t(), String.t(), map(), keyword()) :: {:ok, GitHub.Check.Suite.t()} | {:error, GitHub.Error.t()}
Create a check suite
Creates a check suite manually. By default, check suites are automatically created when you create a check run. You only need to use this endpoint for manually creating check suites when you've disabled automatic creation using "Update repository preferences for check suites".
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 and a null
value for head_branch
.
OAuth apps and personal access tokens (classic) cannot use this endpoint.
resources
Resources
@spec get(String.t(), String.t(), integer(), keyword()) :: {:ok, GitHub.Check.Run.t()} | {:error, GitHub.Error.t()}
Get a check run
Gets a single check run using its id
.
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.
OAuth app tokens and personal access tokens (classic) need the repo
scope to use this endpoint on a private repository.
resources
Resources
@spec get_suite(String.t(), String.t(), integer(), keyword()) :: {:ok, GitHub.Check.Suite.t()} | {:error, GitHub.Error.t()}
Get a check suite
Gets a single check suite using its id
.
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 and a null
value for head_branch
.
OAuth app tokens and personal access tokens (classic) need the repo
scope to use this endpoint on a private repository.
resources
Resources
@spec list_annotations(String.t(), String.t(), integer(), keyword()) :: {:ok, [GitHub.Check.Annotation.t()]} | {:error, GitHub.Error.t()}
List check run annotations
Lists annotations for a check run using the annotation id
.
OAuth app tokens and personal access tokens (classic) need the repo
scope to use this endpoint on a private repository.
options
Options
per_page
: The number of results per page (max 100). For more information, see "Using pagination in the REST API."page
: The page number of the results to fetch. For more information, see "Using pagination in the REST API."
resources
Resources
@spec list_for_ref(String.t(), String.t(), String.t(), keyword()) :: {:ok, map()} | {:error, GitHub.Error.t()}
List check runs for a Git reference
Lists check runs for a commit ref. The ref
can be a SHA, branch name, or a tag name.
Note: The endpoints to manage checks only look 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.
If there are more than 1000 check suites on a single git reference, this endpoint will limit check runs to the 1000 most recent check suites. To iterate over all possible check runs, use the List check suites for a Git reference endpoint and provide the check_suite_id
parameter to the List check runs in a check suite endpoint.
OAuth app tokens and personal access tokens (classic) need the repo
scope to use this endpoint on a private repository.
options
Options
check_name
: Returns check runs with the specifiedname
.status
: Returns check runs with the specifiedstatus
.filter
: Filters check runs by theircompleted_at
timestamp.latest
returns the most recent check runs.per_page
: The number of results per page (max 100). For more information, see "Using pagination in the REST API."page
: The page number of the results to fetch. For more information, see "Using pagination in the REST API."app_id
resources
Resources
@spec list_for_suite(String.t(), String.t(), integer(), keyword()) :: {:ok, map()} | {:error, GitHub.Error.t()}
List check runs in a check suite
Lists check runs for a check suite using its id
.
Note: The endpoints to manage checks only look 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.
OAuth app tokens and personal access tokens (classic) need the repo
scope to use this endpoint on a private repository.
options
Options
check_name
: Returns check runs with the specifiedname
.status
: Returns check runs with the specifiedstatus
.filter
: Filters check runs by theircompleted_at
timestamp.latest
returns the most recent check runs.per_page
: The number of results per page (max 100). For more information, see "Using pagination in the REST API."page
: The page number of the results to fetch. For more information, see "Using pagination in the REST API."
resources
Resources
@spec list_suites_for_ref(String.t(), String.t(), String.t(), keyword()) :: {:ok, map()} | {:error, GitHub.Error.t()}
List check suites for a Git reference
Lists check suites for a commit ref
. The ref
can be a SHA, branch name, or a tag name.
Note: The endpoints to manage checks only look 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 and a null
value for head_branch
.
OAuth app tokens and personal access tokens (classic) need the repo
scope to use this endpoint on a private repository.
options
Options
app_id
: Filters check suites by GitHub Appid
.check_name
: Returns check runs with the specifiedname
.per_page
: The number of results per page (max 100). For more information, see "Using pagination in the REST API."page
: The page number of the results to fetch. For more information, see "Using pagination in the REST API."
resources
Resources
@spec rerequest_run(String.t(), String.t(), integer(), keyword()) :: {:ok, GitHub.EmptyObject.t()} | {:error, GitHub.Error.t()}
Rerequest a check run
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.
For more information about how to re-run GitHub Actions jobs, see "Re-run a job from a workflow run".
OAuth apps and personal access tokens (classic) cannot use this endpoint.
resources
Resources
@spec rerequest_suite(String.t(), String.t(), integer(), keyword()) :: {:ok, GitHub.EmptyObject.t()} | {:error, GitHub.Error.t()}
Rerequest a check suite
Triggers GitHub to rerequest an existing check suite, without pushing new code to a repository. This endpoint will trigger the check_suite
webhook event with the action rerequested
. When a check suite is rerequested
, its status
is reset to queued
and the conclusion
is cleared.
OAuth apps and personal access tokens (classic) cannot use this endpoint.
resources
Resources
@spec set_suites_preferences(String.t(), String.t(), map(), keyword()) :: {:ok, GitHub.Check.SuitePreference.t()} | {:error, GitHub.Error.t()}
Update repository preferences for check suites
Changes the default automatic flow when creating check suites. By default, a check suite is automatically created each time code is pushed to a repository. When you disable the automatic creation of check suites, you can manually Create a check suite. You must have admin permissions in the repository to set preferences for check suites.
resources
Resources
@spec update(String.t(), String.t(), integer(), map(), keyword()) :: {:ok, GitHub.Check.Run.t()} | {:error, GitHub.Error.t()}
Update a check run
Updates a check run for a specific commit in a repository.
Note: The endpoints to manage checks only look 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.
OAuth apps and personal access tokens (classic) cannot use this endpoint.