Unity API Documentation

POST /service/api/console/gsm/{gsmKey}/sites/{siteId}/groups

Creates a group under a given GSM 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/1B40-D0E8-5AEE-4E1A-9BBD/sites/936be3e9-7ed8-46b3-8ea0-862c6dab8fc0/groups

Body Parameters

Additional information for creating a new group.

CreateGroupRequestModel
NameDescriptionTypeAdditional 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": "ba8ca8bc-56ef-41c4-a7a8-1911ce2514d6"
}                    
<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>ba8ca8bc-56ef-41c4-a7a8-1911ce2514d6</PolicyId>
</CreateGroupRequestModel>

Response Information

Resource Description

Information about the created group.

CreateGroupResponseModel
NameDescriptionTypeAdditional Information
GroupId

The id of the group that has been created.

 string

None.

Sample Response

{
  "GroupId": "12cc9baf-7435-4f41-bcbf-5fb3f7488f1c"
}                    
<CreateGroupResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
  <GroupId>12cc9baf-7435-4f41-bcbf-5fb3f7488f1c</GroupId>
</CreateGroupResponseModel>