Updated on 2026-09-23 GMT+08:00

Deleting Tags from the Specified Resource

Function

This API is used to delete tags from the specified resource.

Authorization Information

Each account root user has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
AccessAnalyzer::untagResource	Tagging	analyzer *	g:ResourceTag/<tag-key>	-	-
AccessAnalyzer::untagResource	Tagging	-	g:TagKeys	-	-

URI

POST /v5/{resource_type}/{resource_id}/tags/delete

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
resource_type	Yes	String	Definition: Resource type. Range: analyzers: analyzer
resource_id	Yes	String	Definition Unique identifier of a resource. You can call the ListFindings API to retrieve the list of findings generated by a specified analyzer. The response of this API contains a finding list. Each finding object in the list contains information about the analyzed resource. The resource field is the unique identifier (resource ID) of the resource. Range The value contains 1 to 36 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
tag_keys	Yes	Array of strings	Definition: List of tag keys to be deleted. Constraints: N/A Range: Array length: 1 to 20. Default Value: N/A

Response Parameters

Status code: 200

None

Example Requests

Deleting tags from the specified resource

POST https://{hostname}/v5/{resource_type}/{resource_id}/tags/delete

{
  "tag_keys" : [ "key-1" ]
}

Example Responses

None

Status Codes

Status Code	Description
200	OK

Error Codes

See Error Codes.

Parent topic: Tags