> ## 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.

# Bulk Add Agents

Creates a bulk operation task to add agents to a group. Requires SCAN MANAGER \[40] user permissions. See [Permissions](https://developer.tenable.com/docs/permissions).

<Note>
  External Documentation

  To learn more, visit the [Tenable documentation](https://developer.tenable.com/reference/bulk-add-agents).
</Note>

## Parameters

<div className="integrations-table">
  | 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.                                                       |
</div>

## Example Output

```json theme={"dark"}
{
	"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](https://library.blinkops.com/workflows/bulk-add-agents-with-tenable-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/bulk-add-agents-with-tenable-and-send-results-via-email/canvas" />
</div>