POST /service/api/console/gsm/{gsmKey}/sites/{siteId}/endpoints/commands

Issues an agent command to a list of endpoints, or to all endpoints on a site.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
gsmKey

The GSM console keycode.

 string

Required
siteId

The site identifier.

 string

Required

URI Sample(s)

POST
https://unityapi.webrootcloudav.com/service/api/console/gsm/1E8F-A1CC-09DA-4445-8C25/sites/df66c903-2f40-4d2e-8596-b8e92b9e4fe3/endpoints/commands

Body Parameters

Additional information for issuing an agent command.

SetCommandRequestModel
NameDescriptionTypeAdditional Information
EndpointsList

Comma delimited string of endpoint ids. If not specified, the command gets applied to all endpoints on the site.

 string

None.
Command

The type of the command. Valid values are "scan", "cleanup", "uninstall", "changekeycode", "restart", "sysisolate".

 string

Required
Parameters

The parameters required for the command.

changekeycode and sysisolate commands require a Parameters value to be specified - for changekeycode the value needs to be the keycode to change to, for sysisolate the value needs to be either "on" (for isolating) or "off" (for unisolating).

 string

None.

Sample Request

{
  "EndpointsList": "8a6fc8b0-7839-4134-ac4c-8d05c84b04c9,0eea8b7d-92ac-4498-9f0f-6c41a63f8862",
  "Command": "changekeycode",
  "Parameters": "8BF8-6B08-5F86-411D-8985"
}                    
<SetCommandRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
  <Command>changekeycode</Command>
  <EndpointsList>8a6fc8b0-7839-4134-ac4c-8d05c84b04c9,0eea8b7d-92ac-4498-9f0f-6c41a63f8862</EndpointsList>
  <Parameters>8BF8-6B08-5F86-411D-8985</Parameters>
</SetCommandRequestModel>

Response Information

Resource Description

None. If successful, this API action does not return any data and the response status code will be 204 (No Content).