Updated on 2026-10-12 GMT+08:00

Adding or Deleting Secret Tags in Batches

This API is used to add or delete secret tags in batches.

For details, see Calling APIs.

POST /v1/{project_id}/csms/{secret_id}/tags/action

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details, see Obtaining a Project ID. Constraints N/A Range The value returned by the IAM API is used, which contains 32 characters. Default Value N/A
secret_id	Yes	String	Definition Secret ID Constraints N/A Range N/A Default Value N/A

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. It can be obtained by calling the IAM API. The value of X-Subject-Token in the response header is the user token. This parameter is optional if AK/SK authentication is used. Constraints N/A Range Obtain the value by calling the IAM API for obtaining the user token. Default Value N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
tags	Yes	Array of TagItem objects	Definition Tag list, which is the value pairs of tag keys and values. Constraints N/A Range N/A Default Value N/A
action	Yes	String	Definition Operation to be performed. The value can be create or delete. Constraints N/A Range N/A Default Value N/A
sequence	No	String	Definition A 36-byte serial number of a request message, for example, 919c82d4-8046-4722-9094-35c3c6524cff. Constraints N/A Range N/A Default Value N/A

**Table 4** TagItem
Parameter	Mandatory	Type	Description
key	Yes	String	Definition Tag name Constraints The tag keys of a secret cannot have duplicate values. A tag key can be used for multiple secrets. A secret can have up to 20 tags. Range The value can contain 1 to 128 characters and must match the regular expression *^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}_.:=+\-@])(?<!\s)$. Default Value** N/A
value	No	String	Definition Tag value Constraints N/A Range The value can contain at most 255 characters and must match the regular expression *^([\p{L}\p{Z}\p{N}_.:\/=+\-@])$. Default Value** N/A

Status code: 204

None

Add secret tags in batches.

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

None

Status Code	Description
204	No Content