Skip to content

Create a project label

POST
/api/v4/projects/{id}/labels

Creates a label for a specified project.

id
required
One of:
string

The ID or URL-encoded path of the project

Media type application/json
object
name
required

The name of the label to be created

string
nullable
color
required

The color of the label given in 6-digit hex notation with leading ‘#’ sign (e.g. #FFAABB) or one of the allowed CSS color names

string
nullable
description

The description of label to be created

string
nullable
archived

Whether the label is archived

boolean
nullable
priority

The priority of the label

integer
nullable
Example generated
{
"name": "example",
"color": "example",
"description": "example",
"archived": true,
"priority": 1
}

Created

Media type application/json
object
id
integer format: int64
name
string
description
string
text_color
string
description_html
string
color
string
archived
boolean
open_issues_count
integer
closed_issues_count
integer
open_merge_requests_count
integer
subscribed
boolean
priority
integer
is_project_label
boolean
Example
{
"id": 1,
"name": "bug",
"description": "Bug reported by user",
"text_color": "#FFFFFF",
"description_html": "<p>Bug reported by user</p>",
"color": "#FF0000",
"archived": false,
"open_issues_count": 1,
"closed_issues_count": 0,
"open_merge_requests_count": 1,
"subscribed": false,
"priority": 10
}

Bad Request

Not Found