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

Name	Description	Type	Additional 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/B9CF-F177-4665-4337-AFFD/sites/66e927ad-75b2-420e-89d6-cb8721e63614/endpoints/commands

Body Parameters

Additional information for issuing an agent command.

SetCommandRequestModel

Name	Description	Type	Additional 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.

Name

Description

Type

Additional 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": "3e75ae0e-5664-435a-9a04-39023c89254d,60a5ce8d-88cf-46b0-8a12-4662e37dc116",
  "Command": "changekeycode",
  "Parameters": "BF1C-3D26-2C2D-415D-900D"
}

<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>3e75ae0e-5664-435a-9a04-39023c89254d,60a5ce8d-88cf-46b0-8a12-4662e37dc116</EndpointsList>
  <Parameters>BF1C-3D26-2C2D-415D-900D</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).