Bulk Add Agents - BlinkOps Documentation

Creates a bulk operation task to add agents to a group. Requires SCAN MANAGER [40] user permissions. See Permissions.

External DocumentationTo learn more, visit the Tenable documentation.

Parameters

Parameter	Description
Criteria All Agents	Indicates whether or not to match against all agents.
Criteria Filter Type	Indicates how to combine the `filters` conditions. Possible values are `and` or `or`.
Criteria Filters	An array of string or numeric operations to match against agents. For example, `name:match:laptop` or `core_version:lt:10.0.0`.
Criteria Hardcoded Filters	Additional filters that will always be added as `and` conditions.
Criteria Wildcard	A string used to match against all string-like attributes of an agent.
Group ID	The ID or UUID of the agent group.
Items	An array of agent IDs or agent UUIDs to add to the criteria filter.
Not Items	An array of agent IDs or agent UUIDs to exclude from the criteria filter.

Example Output

{
	"value": {
		"completion_percentage": 0,
		"container_uuid": "3cc182bb-b8ba-4025-9e59-9a81b8a64d5a",
		"last_update_time": 1544032287501,
		"message": "Starting...",
		"start_time": 1544032287496,
		"status": "RUNNING",
		"task_id": "7aaae2f3-544d-497f-b0f0-447d03d7cd55",
		"total_work_units": 3,
		"total_work_units_completed": 0
	}
}

Workflow Library Example

Bulk Add Agents with Tenable and Send Results Via Email

Preview this Workflow on desktop