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

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

```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
	}
}
```