Remove Tags from Assets

Cortex Xpanse REST API

post /public_api/v1/assets/tags/assets_internet_exposure/remove

Remove tags in bulk from a set of assets.

CURL
curl -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ "https://api-yourfqdn/public_api/v1/assets/tags/assets_internet_exposure/remove" \ -d '{ "request_data" : { "filters" : [ { "field" : "field", "value" : [ "value", "value" ], "operator" : "operator" }, { "field" : "field", "value" : [ "value", "value" ], "operator" : "operator" } ], "tags" : [ "tags", "tags" ] } }'
Request
Body
optional
Example: {"request_data":{"filters":[{"field":"string","operator":"string","value":["string"]}],"tags":["string"]}}
request_data
required

A dictionary containing the API request fields.

An empty dictionary returns all results.

filters
optional
Array
field
optional
String
Indicates that the list of assets will be an "asm_id_list".
operator
optional
String
in
value
optional
Array of strings
List of strings, the asset IDs that should be removed from the tag
tags
optional
Array of strings
List of tag names to remove from the assets. These do not need to include the tag family.
Responses

OK

Body
reply
optional
remove_tags
optional
Boolean

Bad Request. Got an invalid JSON.

Body

Unauthorized access. An issue occurred during authentication. This can indicate an incorrect key, id, or other invalid authentication parameters.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.

Internal server error. A unified status for API communication type errors.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.

Forbidden access. The provided API Key does not have the required RBAC permissions to run this API.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.

Internal server error. A unified status for API communication type errors.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.