POST /service/api/console/gsm/{gsmKey}/sites/{siteId}/groups
Creates a group under a given GSM 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/5EEA-1B71-AE2F-4E3D-9FFD/sites/b2090e4a-4871-408f-9cf1-ee90f6a51175/groups
|
Body Parameters
Additional information for creating a new group.
CreateGroupRequestModel| Name | Description | Type | Additional Information |
|---|---|---|---|
| GroupName |
The name of the group. Maximum of 50 characters is allowed. |
string |
Required |
| GroupDescription |
The description of the group. Maximum of 50 characters is allowed. |
string |
Required |
| PolicyId |
The id of the policy applied to the group. If not specified, the default policy will be applied. |
string |
None. |
Sample Request
{
"GroupName": "Test Group",
"GroupDescription": "Description of test group",
"PolicyId": "8e9f5551-636a-44cb-8dc3-312213756306"
}
<CreateGroupRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models"> <GroupDescription>Description of test group</GroupDescription> <GroupName>Test Group</GroupName> <PolicyId>8e9f5551-636a-44cb-8dc3-312213756306</PolicyId> </CreateGroupRequestModel>
Response Information
Resource Description
Information about the created group.
CreateGroupResponseModel| Name | Description | Type | Additional Information |
|---|---|---|---|
| GroupId |
The id of the group that has been created. |
string |
None. |
Sample Response
{
"GroupId": "32dc9f6b-6ade-49ee-8586-03108c7865b5"
}
<CreateGroupResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models"> <GroupId>32dc9f6b-6ade-49ee-8586-03108c7865b5</GroupId> </CreateGroupResponseModel>