Sign in
issues

Add labels to an issue

Adds labels to an issue.

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

Path parameters

ownerstring required

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

repostring required

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

issue_numberinteger required

The number that identifies the issue.

Request body

OR
string[] required
OR

Response

Response

idinteger required

Unique identifier for the label.

node_idstring required
urlstring uri required

URL for the label

namestring required

The name of the label.

descriptionstring nullable required

Optional description of the label, such as its purpose.

colorstring required

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

defaultboolean required

Whether this label comes by default in a new repository.

Example response

[
  {
    "id": 208045946,
    "node_id": "MDU6TGFiZWwyMDgwNDU5NDY=",
    "url": "https://api.github.com/repositories/42/labels/bug",
    "name": "bug",
    "description": "Something isn't working",
    "color": "FFFFFF",
    "default": true
  }
]

Changes

Changed in 1 of the 62 revisions of this API.11

  • 2022-11-28b6e268937c0811See the full diff
    • ▲

      removed subschema #1 subschema #3 from the request body oneOf list

      request-body-one-of-removed

    • ○

      added subschema #1 subschema #3 to the request body oneOf list

      request-body-one-of-added

Of the 62 revisions, 1 has no diff computed.