Adding Labels to Service Tickets
Function
Add labels to a service ticket.
URI
POST /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 associated.  | 
     
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-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
POST https://{endpoint}/v2/servicerequest/cases/case-123/labels?label_ids=123,456,789
null
 Response Example
None
Status Codes
| 
        Status Code  | 
      
        Description  | 
     
|---|---|
| 
        200  | 
      
        Code 200 is returned if the operation is successful.  | 
     
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.