issues

Create a label

Creates a label for the specified repository with the given name and color. The name and color parameters are required. The color must be a valid hexadecimal color code.

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

Request

Base URL: http://HOSTNAME/api/v3
URL: http://HOSTNAME/api/v3/repos/{owner}/{repo}/labels
Auth: none declared

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.

Request body

namestring required

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

idinteger required

node_idstring required

urlstring uri required

URL for the label

namestring required

The name of the label.

descriptionstring nullable required

colorstring required

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

defaultboolean required

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

No recorded changes to this operation across all 50 revisions of this API.