Actions56
- Acquisition Actions
- Asset Actions
- Baseline Actions
- Case Actions
- InterACT Actions
- Organization Actions
- Repository Actions
- Task Actions
- Triage Rule Actions
- User Actions
Asset → Remove Tags
AI-generatedOverview
This node operation removes specified tags from assets within a selected organization. It allows filtering assets by various criteria such as asset IDs, name, IP address, isolation status, label, managed status, online status, platform, search term, and existing tags to precisely target which assets should have tags removed. This is useful for managing and organizing assets by cleaning up or updating their tag metadata in bulk within an organization.
Use Case Examples
- Removing outdated or incorrect tags from all assets in a specific organization.
- Filtering assets by platform and removing tags that are no longer relevant.
- Excluding certain asset IDs from tag removal while applying changes to the rest.
Properties
| Name | Meaning |
|---|---|
| Tags | Comma-separated list of tags to remove from the assets. Tags must contain only lowercase letters, numbers, hyphens, underscores, dots, backslashes, spaces, @, &, and colons. |
| Organization | The organization from which to remove tags from assets. This is required to specify the scope of the operation. |
| Filter Options | Optional filters to narrow down which assets the tag removal applies to, including asset IDs to include or exclude, asset name, IP address, isolation status, label, managed status, online status, platform, search term, and existing tags. |
Output
JSON
success- Indicates whether the tag removal operation was successful.removedTags- List of tags that were removed from the assets.affectedAssetsCount- Number of assets from which tags were removed.
Dependencies
- An API key credential for authenticating with the AIR API service.
Troubleshooting
- Ensure the organization ID is valid and accessible by the API key used.
- Verify that the tags to remove are correctly formatted and allowed characters only.
- Check that the filter options correctly target existing assets; otherwise, no tags will be removed.
- Common error messages may include authorization errors if the API key lacks permissions, or validation errors if tags or organization IDs are invalid.