ASI Assets: Remove Tag

Remove a custom tag from an asset idempotently without deleting the tag definition.

What this endpoint does

Removes a specific custom tag from an asset within a project. The operation is idempotent — removing a tag that is not present on the asset succeeds silently. This removes the tag association from the individual asset only; it does not delete the tag definition from the project. For removing multiple tags at once, use ASI Assets: Bulk Add/Remove Tags. 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 the tag removal to appear in filter queries.

Response data

Returns the tag operation outcome — which tags were removed, which assets were affected, and whether the backend finished processing. When complete is false, use task_ids to poll for completion before assuming the removal is queryable.

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).

string
required

Tag to be removed from the asset.

Responses

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