List labels for a repository
get
http://HOSTNAME/api/v3/repos/{owner}/{repo}/labels
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
application/json
Response
application/json
Response
Color-coded labels help you categorize and filter your issues (just like labels in Gmail).
idinteger(int64)required
Example:208045946
node_idstringrequired
Example:MDU6TGFiZWwyMDgwNDU5NDY=
urlstring(uri)required
URL for the label
Example:https://api.github.com/repositories/42/labels/bug
namestringrequired
The name of the label.
Example:bug
descriptionstring | nullrequired
Example:Something isn't working
colorstringrequired
6-character hex code, without the leading #, identifying the color
Example:FFFFFF
defaultbooleanrequired
Example:true
get/repos/{owner}/{repo}/labels
Path Parameters
Query Parameters
application/json
Create a label
post
http://HOSTNAME/api/v3/repos/{owner}/{repo}/labels
Path Parameters
ownerstringrequired
repostringrequired
Body
application/json
Body
application/json
namestringrequired
The name of the label. Emoji can be added to label names, using either native emoji or colon-style markup. For example, typing :strawberry: will render the emoji 
. For a full list of available emoji and codes, see “Emoji cheat sheet.”
colorstring
The hexadecimal color code for the label, without the leading #.
descriptionstring
A short description of the label. Must be 100 characters or fewer.
Response
application/json
Response
application/json
Response
Label
Color-coded labels help you categorize and filter your issues (just like labels in Gmail).
idinteger(int64)required
Example:208045946
node_idstringrequired
Example:MDU6TGFiZWwyMDgwNDU5NDY=
urlstring(uri)required
URL for the label
Example:https://api.github.com/repositories/42/labels/bug
namestringrequired
The name of the label.
Example:bug
descriptionstring | nullrequired
Example:Something isn't working
colorstringrequired
6-character hex code, without the leading #, identifying the color
Example:FFFFFF
defaultbooleanrequired
Example:true
post/repos/{owner}/{repo}/labels
Path Parameters
Body
{
"name": "bug",
"description": "Something isn't working",
"color": "f29513"
}
application/json
Get a label
get
http://HOSTNAME/api/v3/repos/{owner}/{repo}/labels/{name}
Path Parameters
ownerstringrequired
repostringrequired
namestringrequired
Response
application/json
Response
application/json
Response
Label
Color-coded labels help you categorize and filter your issues (just like labels in Gmail).
idinteger(int64)required
Example:208045946
node_idstringrequired
Example:MDU6TGFiZWwyMDgwNDU5NDY=
urlstring(uri)required
URL for the label
Example:https://api.github.com/repositories/42/labels/bug
namestringrequired
The name of the label.
Example:bug
descriptionstring | nullrequired
Example:Something isn't working
colorstringrequired
6-character hex code, without the leading #, identifying the color
Example:FFFFFF
defaultbooleanrequired
Example:true
get/repos/{owner}/{repo}/labels/{name}
Path Parameters
application/json
Update a label
patch
http://HOSTNAME/api/v3/repos/{owner}/{repo}/labels/{name}
Path Parameters
ownerstringrequired
repostringrequired
namestringrequired
Body
application/json
Body
application/json
new_namestring
The new name of the label. Emoji can be added to label names, using either native emoji or colon-style markup. For example, typing :strawberry: will render the emoji . For a full list of available emoji and codes, see “Emoji cheat sheet.”
colorstring
The hexadecimal color code for the label, without the leading #.
descriptionstring
A short description of the label. Must be 100 characters or fewer.
Response
200 application/json
Response
200 application/json
Response
Label
Color-coded labels help you categorize and filter your issues (just like labels in Gmail).
idinteger(int64)required
Example:208045946
node_idstringrequired
Example:MDU6TGFiZWwyMDgwNDU5NDY=
urlstring(uri)required
URL for the label
Example:https://api.github.com/repositories/42/labels/bug
namestringrequired
The name of the label.
Example:bug
descriptionstring | nullrequired
Example:Something isn't working
colorstringrequired
6-character hex code, without the leading #, identifying the color
Example:FFFFFF
defaultbooleanrequired
Example:true
patch/repos/{owner}/{repo}/labels/{name}
Path Parameters
Body
{
"new_name": "bug :bug:",
"description": "Small bug fix required",
"color": "b01f26"
}
200 application/json
Delete a label
delete
http://HOSTNAME/api/v3/repos/{owner}/{repo}/labels/{name}
Path Parameters
ownerstringrequired
repostringrequired
namestringrequired
Response
204
Response
204
Response
delete/repos/{owner}/{repo}/labels/{name}
Path Parameters
204