Assign or remove profile

post

https://cloud.tenable.com/scanners/null/agents/_bulk/assignToProfile

Assigns or removes agents from a profile by creating an asynchronous bulk operation task.

Note: You can create an agent profile using the Create profile endpoint.

Requires the Scan Manager [40] user role. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

profile_uuid

uuid

required

The unique identifier (UUID) of the agent profile to assign the agents to.

criteria

object

Specifies the criteria you wish to filter agents on. The criteria is used to narrow down the list of agents to perform the specified action on.

items

array

An array of agent IDs or agent UUIDs to add to the criteria filter.

items

not_items

array

An array of agent IDs or agent UUIDs to exclude from the criteria filter.

not_items

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if your request message contained an invalid parameter.

403

Returned if you do not have permission to create or interact with a bulk operation task.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if Tenable Vulnerability Management successfully created the bulk operation task.