GitHub v3 REST API

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

Simple Commit

object

Simple Commit

idstringrequired
tree_idstringrequired
messagestringrequired
timestampstring(date-time)required
authorobjectrequired
Show Child Parameters
committerobjectrequired
Show Child Parameters
Example

CheckSuite

object

A suite of checks performed on the code of a given code change

idintegerrequired

Example:5

node_idstringrequired

Example:MDEwOkNoZWNrU3VpdGU1

head_branchstringrequired

Example:master

head_shastringrequired

The SHA of the head commit that is being checked.

Example:009b8a3a9ccbb128af87f9b1c0f4c62e8a304f6d

statusstringrequired

Allowed values:queuedin_progresscompleted

Example:completed

conclusionstringrequired

Allowed values:successfailureneutralcancelledskippedtimed_outaction_required

Example:neutral

urlstringrequired

Example:https://api.github.com/repos/github/hello-world/check-suites/5

beforestringrequired

Example:146e867f55c26428e5f9fade55a9bbf5e95a7912

afterstringrequired

Example:d6fde92930d4715a2b49857d24b940956b26d2d3

pull_requestsarray[object]required
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
repositoryobjectrequired

Minimal Repository

Show Child Parameters
created_atstring(date-time)required
updated_atstring(date-time)required
head_commitobjectrequired

Simple Commit

Show Child Parameters
latest_check_runs_countintegerrequired
check_runs_urlstringrequired
rerequestableboolean
runs_rerequestableboolean
Example