Skip to content
forgit api docs

Add labels to an issue

POST
/repos/{owner}/{repo}/issues/{issue_number}/labels

Adds labels to an issue.

API method documentation

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
owner
required
string

The account owner of the repository. The name is not case sensitive.

repo
required
string

The name of the repository without the .git extension. The name is not case sensitive.

issue_number
required
integer

The number that identifies the issue.

Request Body

Section titled “Request Body”
Media typeapplication/json
One of:
object
labels

The labels to add to the issue’s existing labels. You can also pass an array of labels directly, but GitHub recommends passing an object with the labels key. To replace all of the labels for an issue, use “Set labels for an issue.”

Array
>= 1 items
One of:
string
Examples
Exampledefault
{
  "labels": [
    "bug",
    "enhancement"
  ]
}

Responses

Section titled “Responses”

200

Section titled “200”

Response

Media typeapplication/json
Array<object>
Label

Color-coded labels help you categorize and filter your issues (just like labels in Gmail).

object
id
required

Unique identifier for the label.

integer format: int64
node_id
required
string
url
required

URL for the label

string format: uri
name
required

The name of the label.

string
description
required

Optional description of the label, such as its purpose.

string
nullable
color
required

6-character hex code, without the leading #, identifying the color

string
default
required

Whether this label comes by default in a new repository.

boolean
Examples
Exampledefault
[
  {
    "id": 208045946,
    "node_id": "MDU6TGFiZWwyMDgwNDU5NDY=",
    "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
    "name": "bug",
    "description": "Something isn't working",
    "color": "f29513",
    "default": true
  },
  {
    "id": 208045947,
    "node_id": "MDU6TGFiZWwyMDgwNDU5NDc=",
    "url": "https://api.github.com/repos/octocat/Hello-World/labels/enhancement",
    "name": "enhancement",
    "description": "New feature or request",
    "color": "a2eeef",
    "default": false
  }
]

301

Section titled “301”

Moved permanently

Media typeapplication/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Examplegenerated
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

404

Section titled “404”

Resource not found

Media typeapplication/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Examplegenerated
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

410

Section titled “410”

Gone

Media typeapplication/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Examplegenerated
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

422

Section titled “422”

Validation failed, or the endpoint has been spammed.

Media typeapplication/json
Validation Error

Validation Error

object
message
required
string
documentation_url
required
string
errors
Array<object>
object
resource
string
field
string
message
string
code
required
string
index
integer
value
One of:
string
nullable
Examplegenerated
{
  "message": "example",
  "documentation_url": "example",
  "errors": [
    {
      "resource": "example",
      "field": "example",
      "message": "example",
      "code": "example",
      "index": 1,
      "value": [
        "example"
      ]
    }
  ]
}