> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Asset Tags

Add, remove or replace custom tags from specified assets.

<Note>
  External Documentation

  To learn more, visit the [CyCognito documentation](https://api.platform.cycognito.com/v1/docs/index.html#/Assets/put_v1_assets_actions__action__tags).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Action     | Choose an action to apply to the tags on the specified entities. Available options:<br /><br /> \* **add** - Apply new tags in addition to the existing tags on the specified entities.<br /> \* **remove** – Clears only the indicated tags from the specified entities.<br /> \* **replace** – Replaces all of the current tags on all of the specified entities with the indicated tags.<br /> \* **remove-all** – Clears all of the existing tags from the specified entities. |
  | Entity IDs | A comma separated list of ids of entities You would like to update their tags. **Note** - Make sure to add the prefix of the asset type. For example, for `ip`, the ID would be `ip/xxx.xxx.xx.xx`.                                                                                                                                                                                                                                                                                |
  | Tags       | A comma separated list of tags, corresponding to the entities ids list.                                                                                                                                                                                                                                                                                                                                                                                                            |
</div>

## Example Output

```json theme={"dark"}
{
	"failed": [
		"string",
		true,
		0,
		"string",
		"string",
		[
			"string"
		],
		{
			"additionalProp1": "string",
			"additionalProp2": "string",
			"additionalProp3": "string"
		},
		"Unknown Type: null"
	],
	"updated": [
		"string"
	]
}
```

## Workflow Library Example

[Update Asset Tags with Cycognito and Send Results Via Email](https://library.blinkops.com/workflows/update-asset-tags-with-cycognito-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/update-asset-tags-with-cycognito-and-send-results-via-email/canvas" />
</div>