Tag API Documentation

1. Update a Label for a Repository

Request

PATCH https://api.gitcode.com/api/v5/repos/{owner}/{repo}/labels/{original_name}

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
owner*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)
repo*	path	string	Repository Path(path)
original_name*	path	string	original name
name	formData	string	name
color	formData	string	color

Response

{
    "id": 12738100,
    "name": "list",
    "color": "#ED4014"
}

Demo

curl --location -g --request PATCH 'https://api.gitcode.com/api/v5/repos/dengmengmian/oneapi/labels/bug?access_token=xxxx' \
--form 'name="list"'

2. Get All Labels of a Repository

Request

GET https://api.gitcode.com/api/v5/repos/{owner}/{repo}/labels

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
owner*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)
repo*	path	string	Repository Path(path)

Response

[
    {
        "id": 12738107,
        "name": "wontfix",
        "color": "#CCCCCC",
        "repository_id": 4066481
    },
    {
        "id": 12738106,
        "name": "question",
        "color": "#D876E3",
        "repository_id": 4066481
    }
]

Demo

curl --location -g --request GET 'https://api.gitcode.com/api/v5/repos/dengmengmian/oneapi/labels?access_token=xxxxx'

3. Create a Label for a Repository

Request

POST https://api.gitcode.com/api/v5/repos/{owner}/{repo}/labels

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
owner*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)
repo*	path	string	Repository Path(path)
name*	formData	string	new name
color*	formData	string	color, eg: #fff

Response

{
    "id": 12738109,
    "name": "测试1",
    "color": "#fff"
}

Demo

curl --location -g --request POST 'https://api.gitcode.com/api/v5/repos/dengmengmian/oneapi/labels?access_token=xxxx' \
--form 'name="测试"' \
--form 'color="#fff"'

4. Delete a Label from a Repository

Request

DELETE https://api.gitcode.com/api/v5/repos/{owner}/{repo}/labels/{name}

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
owner*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)
repo*	path	string	Repository Path(path)
name*	path	string	标签名称

Response

无

Demo

curl --location -g --request DELETE 'https://api.gitcode.com/api/v5/repos/dengmengmian/oneapi/labels/list?access_token=yuBy'

5. Delete All Labels of an Issue

Request

DELETE https://api.gitcode.com/api/v5/repos/{owner}/{repo}/issues/{number}/labels

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
owner*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)
repo*	path	string	Repository Path(path)
number*	path	string	issue number

Response

无

Demo

curl --location -g --request DELETE 'https://api.gitcode.com/api/v5/repos/{owner}/{repo}/issues/{number}/labels?access_token=token'

6. Replace All Labels of an Issue

Request

PUT https://api.gitcode.com/api/v5/repos/{owner}/{repo}/issues/{number}/labels

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
owner*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)
repo*	path	string	Repository Path(path)
number*	path	string	issue number
body*	body	array	labels，eg: [“feat”, “bug”]

Response

无

Demo

curl --location -g --request PUT 'https://api.gitcode.com/api/v5/repos/{owner}/{repo}/issues/{number}/labels?access_token=token'\
--header 'Content-Type: application/json' \
--data-raw '["feat", "bug"]'

7. Get All Labels of an Enterprise(v5)

Request

GET https://api.gitcode.com/api/v5/enterprises/{enterprise}/labels

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
enterprise*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)

Response

[
    {
        "id": 471,
        "name": "aaaaa",
        "color": "#2865E0",
        "created_at": "2024-11-22T11:25:36.769+08:00",
        "updated_at": "2024-11-22T11:25:36.769+08:00"
    }
]

Demo

curl --location 'https://api.gitcode.com/api/v5/enterprises/xiaogang_test/labels?access_token=token'

8. Get the List of Labels for an Enterprise(v8)

Request

GET https://api.gitcode.com/api/v8/enterprises/{enterprise}/labels

Parameter	Type	Data Type	Description
access_token*	query	string	personal access token
enterprise*	path	string	Repository Ownership Path (Company, Organization, or Personal Path)
search	query	string	keywords
direction	query	string	asc/desc
page	query	string	Current Page Number
per_page	query	string	Items Per Page, Maximum 100

Response

[
    {
        "id": 382218,
        "name": "bug",
        "color": "#e03529"
    }
]

Demo

curl --location 'https://api.gitcode.com/api/v8/enterprises/xiaogang_test/labels?access_token=token'