GitHub v3 REST API

Contributor

object

Contributor

loginstring
idinteger
node_idstring
avatar_urlstring(uri)
gravatar_idstring
urlstring(uri)
html_urlstring(uri)
followers_urlstring(uri)
following_urlstring
gists_urlstring
starred_urlstring
subscriptions_urlstring(uri)
organizations_urlstring(uri)
repos_urlstring(uri)
events_urlstring
received_events_urlstring(uri)
typestringrequired
site_adminboolean
contributionsintegerrequired
emailstring
namestring
Example

Deployment

object

A request for a specific ref(branch,sha,tag) to be deployed

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

shastringrequired

Example:a84d88e7554fc1fa21bcbc4efae3c782a70d2b9d

refstringrequired

The ref to deploy. This can be a branch, tag, or sha.

Example:topic-branch

taskstringrequired

Parameter to specify a task to execute

Example:deploy

payloadOne Of
required
Variant 1object
* Additional properties are allowed.
original_environmentstring

Example:staging

environmentstringrequired

Name for the target deployment environment.

Example:production

descriptionstringrequired

Example:Deploy request from hubot

creatorobjectrequired

Simple User

Show Child Parameters
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

Deployment Status

object

The status of a deployment.

urlstring(uri)required

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

idintegerrequired

Example:1

node_idstringrequired

Example:MDE2OkRlcGxveW1lbnRTdGF0dXMx

statestringrequired

The state of the status.

Allowed values:errorfailureinactivependingsuccessqueuedin_progress

Example:success

creatorobjectrequired

Simple User

Show Child Parameters
descriptionstringrequired

A short description of the status.

Default:

<= 140 characters

Example:Deployment finished successfully.

environmentstring

The environment of the deployment that the status is for.

Default:

Example:production

target_urlstring(uri)required

Deprecated: the URL to associate with this status.

Default:

Example:https://example.com/deployment/42/output

created_atstring(date-time)required

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

updated_atstring(date-time)required

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

deployment_urlstring(uri)required

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

repository_urlstring(uri)required

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

environment_urlstring(uri)

The URL for accessing your environment.

Default:

Example:https://staging.example.com/

log_urlstring(uri)

The URL to associate with this status.

Default:

Example:https://example.com/deployment/42/output

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

Short Blob

object

Short Blob

urlstringrequired
shastringrequired
Example

Blob

object

Blob

contentstringrequired
encodingstringrequired
urlstring(uri)required
shastringrequired
sizeintegerrequired
node_idstringrequired
highlighted_contentstring
Example