Updated on 2025-09-10 GMT+08:00

Deleting a Tag

Function

This API is used to delete a tag.

Calling Method

For details, see Calling APIs.

URI

DELETE /v1/ipdprojectservice/projects/{project_id}/tags/{label_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition:

32-character UUID of a project, which uniquely identifies a project. Obtain the value of this parameter from the project_id field in the response body of the Querying the Project List API.

Constraints:

Regular expression: ^[A-Za-z0-9]{32}$

Options:

N/A

Default value:

N/A

label_id

Yes

String

Tag ID.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

status

String

Request status.

message

String

Cause of a failed request.

result

LabelEntity object

Tag details.

Table 3 LabelEntity

Parameter

Type

Description

id

String

Definition:

Tag ID, which is the value of id in the response body returned by calling the Querying the Tag List API.

Constraints:

Regular expression: ^([0-9]{18,19})$

Options:

N/A

Default value:

N/A

label_type

String

Definition:

Type of the work item to which the label belongs, corresponding to the type field of the work item.

Constraints:

Minimum length: 0 characters. Maximum length: 32 characters.

Options:

N/A

Default value:

N/A

color

String

Definition:

Tag RGB color.

Constraints:

Minimum length: 0 characters. Maximum length: 16 characters.

Options:

N/A

Default value:

N/A

title

String

Definition:

Tag title.

Constraints:

Minimum length: 2 characters. Maximum length: 256 characters.

Options:

N/A

Default value:

N/A

Example Requests

Deleting a Specified Tag

https://{endpoint}/v1/ipdprojectservice/projects/b54914d464d1498a97d683ef198ec448/tags/1030868827803529217

Example Responses

Status code: 200

OK

{
  "status" : "success",
  "message" : "ok",
  "result" : {
    "id" : "1030868827803529217"
  }
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.