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/45BA-4CC2-6FA1-4AD7-BFED/sites/79e71f67-84e8-4fdb-95d1-c2eb883ee987/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". |
string |
Required |
| Parameters |
The parameters required for the command (e.g. required for the "changekeycode" command to specify the keycode). |
string |
None. |
Sample Request
{
"EndpointsList": "83732fe9-17d9-47da-ac51-9e419e7266fe,c6b1ffab-1fba-4e3c-9e8a-b3c616a28102",
"Command": "changekeycode",
"Parameters": "1294-6C72-F987-44B7-9F6B"
}
<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>83732fe9-17d9-47da-ac51-9e419e7266fe,c6b1ffab-1fba-4e3c-9e8a-b3c616a28102</EndpointsList> <Parameters>1294-6C72-F987-44B7-9F6B</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).