GitHub v3 REST API

List repository tags

get
{protocol}://{hostname}/api/v3/repos/{owner}/{repo}/tags

Query Parameters

per_pageinteger

Results per page (max 100)

Default:30

pageinteger

Page number of the results to fetch.

Default:1

Path Parameters

ownerstringrequired
repostringrequired

Response

200 application/json

Response

Tag

namestringrequired

Example:v0.1

commitobjectrequired
Show Child Parameters
zipball_urlstring(uri)required

Example:https://github.com/octocat/Hello-World/zipball/v0.1

tarball_urlstring(uri)required

Example:https://github.com/octocat/Hello-World/tarball/v0.1

node_idstringrequired
get/repos/{owner}/{repo}/tags
 
200 application/json

Download a repository archive (tar)

Gets a redirect URL to download a tar archive for a repository. If you omit :ref, the repository’s default branch (usually
master) will be used. Please make sure your HTTP framework is configured to follow redirects or you will need to use
the Location header to make a second GET request.
Note: For private repositories, these links are temporary and expire after five minutes.

get
{protocol}://{hostname}/api/v3/repos/{owner}/{repo}/tarball/{ref}

Path Parameters

ownerstringrequired
repostringrequired
refstringrequired

Response

302

Response

get/repos/{owner}/{repo}/tarball/{ref}
 
302

List repository teams

get
{protocol}://{hostname}/api/v3/repos/{owner}/{repo}/teams

Query Parameters

per_pageinteger

Results per page (max 100)

Default:30

pageinteger

Page number of the results to fetch.

Default:1

Path Parameters

ownerstringrequired
repostringrequired

Response

200 application/json

Response

Groups of organization members that gives permissions on specified repositories.

idintegerrequired
node_idstringrequired
namestringrequired
slugstringrequired
descriptionstring | nullrequired
privacystring
permissionstringrequired
permissionsobject
Show Child Parameters
urlstring(uri)required
html_urlstring(uri)required

Example:https://github.com/orgs/rails/teams/core

members_urlstringrequired
repositories_urlstring(uri)required
parentobject | nullrequired

Groups of organization members that gives permissions on specified repositories.

Show Child Parameters
get/repos/{owner}/{repo}/teams
 
200 application/json

Get all repository topics

get
{protocol}://{hostname}/api/v3/repos/{owner}/{repo}/topics

Query Parameters

pageinteger

Page number of the results to fetch.

Default:1

per_pageinteger

Results per page (max 100)

Default:30

Path Parameters

ownerstringrequired
repostringrequired

Response

application/json

Response

Topic

A topic aggregates entities that are related to a subject.

namesarray[string]required
get/repos/{owner}/{repo}/topics
 
application/json

Replace all repository topics

put
{protocol}://{hostname}/api/v3/repos/{owner}/{repo}/topics

Path Parameters

ownerstringrequired
repostringrequired

Body

application/json
namesarray[string]required

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

Response

application/json

Response

Topic

A topic aggregates entities that are related to a subject.

namesarray[string]required
put/repos/{owner}/{repo}/topics

Body

{ "names": [ "octocat", "atom", "electron", "api" ] }
 
application/json