Back

POST securitygroups

Create a new security group. Admin

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

None.

Body Parameters (SecurityGroup)

This object takes all the parameters needed to create a new security group.

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the security group.
Group string Required

Name of the security group. (Max length 100 characters)
Description string

Description of the security group
SiteID globally unique identifier Required

ID of the site for the security group.
Created date ReadOnly

Date the security group was created.
CreatedBy globally unique identifier ReadOnly

ID of the person that created the security group.
Updated date ReadOnly

Date the security group was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the person who updated the security group.
Deleted boolean ReadOnly

Deleted status of the security group.
DeletedByRef boolean ReadOnly

Deleted by reference status of the security group.

Request Formats

application/xml, text/xml

Sample
<SecurityGroup xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>4c8d5f45-5e3b-4173-97bc-b9c1cce06b8c</ID>
  <Group>sample string 1</Group>
  <Description>sample string 2</Description>
  <SiteID>a432094f-158a-4d7a-9d31-bbc0d0d41da3</SiteID>
</SecurityGroup>

application/json, text/json

Sample
{
  "ID": "4c8d5f45-5e3b-4173-97bc-b9c1cce06b8c",
  "Group": "sample string 1",
  "Description": "sample string 2",
  "SiteID": "a432094f-158a-4d7a-9d31-bbc0d0d41da3"
}

Response Information

Resource Description (SecurityGroup)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the security group.
Group string Required

Name of the security group. (Max length 100 characters)
Description string

Description of the security group
SiteID globally unique identifier Required

ID of the site for the security group.
Created date ReadOnly

Date the security group was created.
CreatedBy globally unique identifier ReadOnly

ID of the person that created the security group.
Updated date ReadOnly

Date the security group was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the person who updated the security group.
Deleted boolean ReadOnly

Deleted status of the security group.
DeletedByRef boolean ReadOnly

Deleted by reference status of the security group.

Response Formats

application/xml, text/xml

Sample
<SecurityGroup xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>aa07ef73-d2d2-4e31-a275-41645497be36</ID>
  <Group>sample string 1</Group>
  <Description>sample string 2</Description>
  <SiteID>499d69b9-177c-43a9-a5f1-90daf530341a</SiteID>
  <Created>2025-08-04T02:21:47.3829599+00:00</Created>
  <CreatedBy>cdc8d7ed-72e6-407c-856c-0d348b44c85e</CreatedBy>
  <Updated>2025-08-04T02:21:47.3829599+00:00</Updated>
  <UpdatedBy>39e67bc7-dbdc-4535-970c-b40a1d0ea026</UpdatedBy>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
</SecurityGroup>

application/json, text/json

Sample
{
  "ID": "aa07ef73-d2d2-4e31-a275-41645497be36",
  "Group": "sample string 1",
  "Description": "sample string 2",
  "SiteID": "499d69b9-177c-43a9-a5f1-90daf530341a",
  "Created": "2025-08-04T02:21:47.3829599+00:00",
  "CreatedBy": "cdc8d7ed-72e6-407c-856c-0d348b44c85e",
  "Updated": "2025-08-04T02:21:47.3829599+00:00",
  "UpdatedBy": "39e67bc7-dbdc-4535-970c-b40a1d0ea026",
  "Deleted": true,
  "DeletedByRef": true
}