Deleting Service Ticket Associated Labels
Function Description
To delete labels associated with a service ticket.
Debugging
You can debug this API in API Explorer.
URI
DELETE /v2/servicerequest/cases/{case_id}/labels
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| case_id | Yes | String | Specifies the service ticket ID. Minimum length: 1 Maximum length: 64 |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| label_ids | Yes | Array | Specifies the list of at most five IDs of the labels to be disassociated. |
Request Parameters
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| X-Auth-Token | Yes | String | Specifies the user token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Minimum length: 1 Maximum length: 5000 |
| X-Site | No | Integer | Specifies the site. The value can be 0 (China site) or 1 (International site). If this parameter is left blank, it is 0 by default. Minimum value: 0 Maximum value: 1 |
| X-Language | No | String | Specifies the language environment. The value is a common language description character string, for example, zh-cn. It is zh-cn by default. Some internationalization information, such as the service ticket type and name, is displayed based on the language environment. Minimum length: 1 Maximum length: 32 |
| X-Time-Zone | No | String | Specifies the time zone. The value is a common time zone description character string, for example, GMT+8. It is GMT+8 by default. Time-related data is processed based on the time zone of the environment. Minimum length: 1 Maximum length: 32 |
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Specifies the error code. Minimum length: 0 Maximum length: 32 |
| error_msg | String | Description of the error. Minimum length: 0 Maximum length: 32 |
Request Example
DELETE https://{endpoint}/v2/servicerequest/cases/case-123/labels?label_ids=123,456,789
null Response Example
None
Status Code
| Status Code | Description |
|---|---|
| 200 | Code 200 is returned. |
Error Code
See here.
Last Article: Adding Service Ticket Associated Labels
Next Article: Service Ticket Quota Management
Did this article solve your problem?
Thank you for your score！Your feedback would help us improve the website.