Actions99
- InterACT Actions
- Notification Actions
- Organization Actions
- Task Actions
- Policy Actions
- Repository Actions
- Setting Actions
- Triage Rule Actions
- User Actions
- Acquisition Actions
- API Token Actions
- Asset Actions
- Auto Asset Tag Actions
- Baseline Actions
- Case Actions
- Evidence Actions
Overview
The node enables management of endpoint assets within the Binalyze AIR platform, specifically allowing users to remove tags from selected assets. This operation is useful for organizing and maintaining asset metadata by cleaning up or updating tag assignments. For example, if certain tags are no longer relevant or were applied in error, this node can batch-remove those tags from multiple assets based on various filtering criteria.
Common scenarios include:
- Removing outdated or deprecated tags from a group of assets.
- Cleaning up tags after an incident response or audit.
- Adjusting asset categorization dynamically as organizational needs evolve.
Properties
| Name | Meaning |
|---|---|
| Tags | Comma-separated list of tags to remove from the selected assets (e.g., tag1,tag2,tag3). This is required. |
| Filter Options | A collection of filters to select which assets will have tags removed. Filters include: • Excluded Asset IDs: Comma-separated asset IDs to exclude. • Filter By Asset Name: Filter assets by name. • Filter By IP Address: Filter assets by IP. • Filter By Isolation Status: Choose from "Isolated" or "Not Isolated". • Filter By Managed Status: Choose from "Managed" or "Unmanaged". • Filter By Online Status: Choose from "Online" or "Offline". • Filter By Organization: Select organization by list, ID, or name. • Filter By Platform: Choose from "Windows", "macOS", or "Linux". • Filter By Search Term: General search term. • Filter By Tags: Comma-separated tags to filter assets. • Included Asset IDs: Comma-separated asset IDs to explicitly include. |
Output
The node outputs JSON data representing the result of the tag removal operation. Typically, this includes information about the assets affected and confirmation of tag removals. The exact structure depends on the underlying API response but generally contains details such as asset identifiers and status messages.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the Binalyze AIR platform via an API key credential configured in n8n.
- The node relies on the Binalyze AIR API to perform asset tag management operations.
- Proper permissions on the API key are necessary to modify asset tags.
Troubleshooting
Issue: No assets are updated despite providing tags and filters.
Cause: Filters may be too restrictive or incorrectly specified, resulting in zero matching assets.
Resolution: Review and adjust filter criteria to ensure they match intended assets.Issue: Error indicating unknown resource or operation.
Cause: Misconfiguration of the Resource or Operation parameters.
Resolution: Confirm that "Asset" is selected as the resource and "Remove Tags" as the operation.Issue: Authentication errors or permission denied.
Cause: Invalid or insufficient API credentials.
Resolution: Verify the API key credential is valid and has appropriate permissions.Issue: Malformed tag input causing failure.
Cause: Tags not provided as comma-separated strings or empty tags.
Resolution: Ensure tags are entered correctly as comma-separated values without extra spaces or invalid characters.
Links and References
- Binalyze AIR Official Documentation — For detailed API and asset management references.
- n8n Documentation — For general guidance on using credentials and configuring nodes.