Labels

List all labels for this repository 

GET /repos/:owner/:repo/labels

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"

[
  {
    "id": 208045946,
    "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
    "name": "bug",
    "color": "f29513",
    "default": true
  }
]

Get a single label 

GET /repos/:owner/:repo/labels/:name

Response

Status: 200 OK

{
  "id": 208045946,
  "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
  "name": "bug",
  "color": "f29513",
  "default": true
}

Create a label 

POST /repos/:owner/:repo/labels

Parameters

Name Type Description
name string Required. The name of the label.
color string Required. A 6 character hex code, without the leading #, identifying the color. 
{
  "name": "bug",
  "color": "f29513"
}

Response

Status: 201 Created
Location: https://api.github.com/repos/octocat/Hello-World/labels/bug

{
  "id": 208045946,
  "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
  "name": "bug",
  "color": "f29513",
  "default": true
}

Update a label 

PATCH /repos/:owner/:repo/labels/:name

Parameters

Name Type Description
name string The name of the label.
color string A 6 character hex code, without the leading #, identifying the color. 
{
  "name": "bug",
  "color": "f29513"
}

Response

Status: 200 OK

{
  "id": 208045946,
  "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
  "name": "bug",
  "color": "f29513",
  "default": true
}

Delete a label 

DELETE /repos/:owner/:repo/labels/:name

Response

Status: 204 No Content

List labels on an issue 

GET /repos/:owner/:repo/issues/:number/labels

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"

[
  {
    "id": 208045946,
    "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
    "name": "bug",
    "color": "f29513",
    "default": true
  }
]

Add labels to an issue 

POST /repos/:owner/:repo/issues/:number/labels

Input

[
  "Label1",
  "Label2"
]

Response

Status: 200 OK

[
  {
    "id": 208045946,
    "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
    "name": "bug",
    "color": "f29513",
    "default": true
  }
]

Remove a label from an issue 

DELETE /repos/:owner/:repo/issues/:number/labels/:name

Response

Status: 204 No Content

Replace all labels for an issue 

PUT /repos/:owner/:repo/issues/:number/labels

Input

[
  "Label1",
  "Label2"
]

Sending an empty array ([]) will remove all Labels from the Issue.

Response

Status: 200 OK

[
  {
    "id": 208045946,
    "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
    "name": "bug",
    "color": "f29513",
    "default": true
  }
]

Remove all labels from an issue 

DELETE /repos/:owner/:repo/issues/:number/labels

Response

Status: 204 No Content

Get labels for every issue in a milestone 

GET /repos/:owner/:repo/milestones/:number/labels

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"

[
  {
    "id": 208045946,
    "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
    "name": "bug",
    "color": "f29513",
    "default": true
  }
]