Set labels for an issue

PUT

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

Removes any previous labels and sets the new labels for an issue.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.github.com/repos///issues//labels' \
--header 'Content-Type: application/json' \
--data-raw '{
    "labels": [
        "bug",
        "enhancement"
    ]
}'

响应示例

200 - 示例 1

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

owner

string

必需

repo

string

必需

issue_number

integer

必需

issue_number parameter

Body 参数application/json

可选

labels

array[string]

可选

The names of the labels to add to the issue. You can pass an empty array to remove all labels. Note: Alternatively, you can pass a single label as a string or an array of labels directly, but GitHub recommends passing an object with the labels key.

示例

返回响应

🟢200Response

application/json

Body

array of:

color

string

必需

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

示例值:

FFFFFF

default

boolean

必需

示例值:

true

description

string | null

必需

示例值:

Something isn't working

integer <int64>

必需

示例值:

208045946

name

string

必需

The name of the label.

示例值:

bug

node_id

string

必需

示例值:

MDU6TGFiZWwyMDgwNDU5NDY=

url

string <uri>

必需

URL for the label

示例值:

https://api.github.com/repositories/42/labels/bug

🟠410410

🟠422422

修改于 2022-08-24 13:05:03

Add labels to an issue

Remove a label from an issue