Issue a command to a device

Force a device to Scan, Patch, or Reboot for immediate execution. Note: The installAllUpdates option ignores any Policy Filters

Request
Security:
path Parameters
id
required
integer

Server ID for the specified device

query Parameters
o
required
integer

Organization ID for the specified device

Request Body schema: application/json
command_type_name
required
string
Enum: Description
GetOS

Triggers a device scan.

InstallUpdate

Installs a specific patch.

InstallAllUpdates

Installs all available patches. NOTE: This ignores any Policy Filters!

policy_{policy_id}_test

Evaluates compliance against a Worklet.

policy_{policy_id}_remediate

Forces remediation of a Worklet or Required Software Policy.

Reboot

Forces a reboot.

args
string

Only needed for InstallUpdate. Includes the name of the patches to install.

Responses
201

Command submitted successfully

401

Access token is missing or invalid

403

You do not have permission to perform this action.

post/servers/{id}/queues
Request samples
application/json
{
  • "command_type_name": "GetOS"
}
Response samples
application/json
{
  • "errors": [
    • "Unauthorized"
    ]
}