DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer
  1. Tenable Platform & Settings
  2. Agent Tasks

Remove agents from group

post
https://cloud.tenable.com/scanners/null/agent-groups//agents/_bulk/remove

Creates a bulk operation task to remove agents from a group.

Requires the Scan Manager [40] user role or the VM.VM_SENSOR.VM_AGENT.EDIT custom role privilege. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

The ID or UUID of the agent group.

Body Params
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.

Updated 5 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html

Updated 5 months ago

Did this page help you?