GitHub v3 REST API

Status Check Policy

object

Status Check Policy

urlstring(uri)required

Example:https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks

strictbooleanrequired

Example:true

contextsarray[string]required

Example:continuous-integration/travis-ci

contexts_urlstring(uri)required

Example:https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks/contexts

Example

Protected Branch

object

Branch protections protect branches

urlstring(uri)required
required_status_checksobject

Status Check Policy

Show Child Parameters
required_pull_request_reviewsobject
Show Child Parameters
required_signaturesobject
Show Child Parameters
enforce_adminsobject
* Additional properties are NOT allowed.
Show Child Parameters
required_linear_historyobject
* Additional properties are NOT allowed.
Show Child Parameters
allow_force_pushesobject
* Additional properties are NOT allowed.
Show Child Parameters
allow_deletionsobject
* Additional properties are NOT allowed.
Show Child Parameters
restrictionsobject

Branch Restriction Policy

Show Child Parameters
required_conversation_resolutionobject
* Additional properties are NOT allowed.
Show Child Parameters
Example

Deployment

object

A deployment created as the result of an Actions check run from a workflow that references an environment

urlstring(uri)required

Example:https://api.github.com/repos/octocat/example/deployments/1

idintegerrequired

Unique identifier of the deployment

Example:42

node_idstringrequired

Example:MDEwOkRlcGxveW1lbnQx

taskstringrequired

Parameter to specify a task to execute

Example:deploy

original_environmentstring

Example:staging

environmentstringrequired

Name for the target deployment environment.

Example:production

descriptionstringrequired

Example:Deploy request from hubot

created_atstring(date-time)required

Example:2012-07-20T01:19:13Z

updated_atstring(date-time)required

Example:2012-07-20T01:19:13Z

statuses_urlstring(uri)required

Example:https://api.github.com/repos/octocat/example/deployments/1/statuses

repository_urlstring(uri)required

Example:https://api.github.com/repos/octocat/example

transient_environmentboolean

Specifies if the given environment is will no longer exist at some point in the future. Default: false.

Example:true

production_environmentboolean

Specifies if the given environment is one that end-users directly interact with. Default: false.

Example:true

performed_via_github_appobject

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.

Show Child Parameters
Example

CheckRun

object

A check performed on the code of a given code change

idintegerrequired

The id of the check.

Example:21

head_shastringrequired

The SHA of the commit that is being checked.

Example:009b8a3a9ccbb128af87f9b1c0f4c62e8a304f6d

node_idstringrequired

Example:MDg6Q2hlY2tSdW40

external_idstringrequired

Example:42

urlstringrequired

Example:https://api.github.com/repos/github/hello-world/check-runs/4

html_urlstringrequired

Example:https://github.com/github/hello-world/runs/4

details_urlstringrequired

Example:https://example.com

statusstringrequired

The phase of the lifecycle that the check is currently in.

Allowed values:queuedin_progresscompleted

Example:queued

conclusionstringrequired

Allowed values:successfailureneutralcancelledskippedtimed_outaction_required

Example:neutral

started_atstring(date-time)required

Example:2018-05-04T01:14:52Z

completed_atstring(date-time)required

Example:2018-05-04T01:14:52Z

outputobjectrequired
Show Child Parameters
namestringrequired

The name of the check.

Example:test-coverage

check_suiteobjectrequired
Show Child Parameters
appobjectrequired

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.

Show Child Parameters
pull_requestsarray[object]required
Show Child Parameters
deploymentobject

A deployment created as the result of an Actions check run from a workflow that references an environment

Show Child Parameters
Example

Check Annotation

object

Check Annotation

pathstringrequired

Example:README.md

start_lineintegerrequired

Example:2

end_lineintegerrequired

Example:2

start_columnintegerrequired

Example:5

end_columnintegerrequired

Example:10

annotation_levelstringrequired

Example:warning

titlestringrequired

Example:Spell Checker

messagestringrequired

Example:Check your spelling for 'banaas'.

raw_detailsstringrequired

Example:Do you mean 'bananas' or 'banana'?

blob_hrefstringrequired
Example