ASI Assets: Bulk Add/Remove Tags

Add and remove multiple custom tags on a single asset atomically in one request.

What this endpoint does

Atomically adds and/or removes multiple custom tags from a single asset in one request. More efficient than calling ASI Assets: Apply Tag or ASI Assets: Remove Tag individually. New tags not yet defined on the project are created automatically. The add_tags and remove_tags arrays can be sent together or separately, but a tag cannot appear in both arrays in the same request (returns 422). The asset_id is the asset's domain or IP address.

The operation is asynchronous — the API waits up to 2 seconds for completion. If complete is false, poll using the returned task_ids via Tagging: Get Task Status. Even when complete is true, allow up to 5 minutes for tag changes to appear in filter queries.

Response data

Returns the tag operation outcome — which tags were added or removed, which assets were affected, and whether the backend finished processing. Use task_ids to poll for completion when the operation is still in progress.

Path Params
string
required
string
required

Filter for the specific asset, which will be either a IP or domain value (examples: 192.88.99.2 or www.example.com).

Body Params

Tags to add and remove from the asset

array | null

List of tag names to apply to the assets

array | null

List of tag names to remove from the assets

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json