Binalyze AIR icon

Binalyze AIR

Manage Binalyze AIR resources

Actions99

Overview

The node enables managing "Auto Asset Tags" within the Binalyze AIR platform. Specifically, the "Update Auto Asset Tag" operation allows users to modify an existing auto asset tag by specifying its identifier and updating its properties such as name, query criteria, and associated organization.

This node is useful in scenarios where automated tagging of assets based on dynamic queries is required to organize or classify endpoint assets efficiently. For example, security teams can update tags that automatically group devices with certain characteristics (e.g., OS version, installed software) to streamline incident response or compliance reporting.

Properties

Name Meaning
Auto Asset Tag The target auto asset tag to update. Can be selected from a list, specified by ID (alphanumeric, hyphens, underscores only), or by name.
Tag Name The new or updated name for the auto asset tag.
Query The query string defining the criteria for the auto asset tag. This determines which assets are included in the tag.
Additional Fields Optional extra fields to set on the auto asset tag. Currently supports:
- Organization: Specifies the organization this tag applies to. Use 0 for all organizations. Can be selected from a list, by numeric ID, or by name.

Output

The node outputs JSON data representing the updated auto asset tag object as returned by the Binalyze AIR API. This typically includes fields such as the tag's unique identifier, name, query, associated organization, and metadata about the tag.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Binalyze AIR API using a configured API authentication credential.
  • The node depends on the Binalyze AIR environment being accessible and the user having permissions to update auto asset tags.
  • No additional external services or environment variables are needed beyond the API credential.

Troubleshooting

  • Invalid Auto Asset Tag ID: If specifying the tag by ID, ensure it contains only letters, numbers, hyphens, and underscores. Otherwise, the node will reject the input.
  • Missing Required Fields: The "Tag Name" and "Query" fields are mandatory. Omitting them will cause errors.
  • Permission Denied: Ensure the API credential used has sufficient rights to update auto asset tags.
  • Organization ID Issues: When specifying an organization, use a positive number or 0 for all organizations. Invalid IDs will cause validation errors.
  • API Connectivity: Network issues or incorrect API credentials will prevent successful execution.

Links and References

Discussion