POST security

Request Information

URI Parameters

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

None.

Body Parameters (Permission)

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

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

Request Formats

application/xml, text/xml

Sample

<Permission xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>1af7eeff-ee15-4d64-afdd-169c784ca4e8</ID>
  <RowID>bdf55943-f7bb-4cb4-b975-5add7d672b58</RowID>
  <PrincipalID>d5d0de6d-1207-41ae-989c-1387c809dcc9</PrincipalID>
  <ChildType>1</ChildType>
  <CreateState>1</CreateState>
  <ReadState>1</ReadState>
  <UpdateState>1</UpdateState>
  <DeleteState>1</DeleteState>
  <DelegateState>1</DelegateState>
</Permission>

application/json, text/json

Sample

{
  "ID": "1af7eeff-ee15-4d64-afdd-169c784ca4e8",
  "RowID": "bdf55943-f7bb-4cb4-b975-5add7d672b58",
  "PrincipalID": "d5d0de6d-1207-41ae-989c-1387c809dcc9",
  "ChildType": 1,
  "CreateState": 1,
  "ReadState": 1,
  "UpdateState": 1,
  "DeleteState": 1,
  "DelegateState": 1
}

Response Information

Resource Description (Permission)

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

Response Formats

application/xml, text/xml

Sample

<Permission xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>c1cdf056-25b2-4a93-8ab4-27b910d138ea</ID>
  <RowID>f00a39ea-ba83-4e30-a171-2df44176fc0f</RowID>
  <PrincipalID>8e64ee0c-9352-48d7-8d8f-88028a8ab982</PrincipalID>
  <ChildType>1</ChildType>
  <CreateState>1</CreateState>
  <ReadState>1</ReadState>
  <UpdateState>1</UpdateState>
  <DeleteState>1</DeleteState>
  <DelegateState>1</DelegateState>
  <SiteID>851de882-1dd0-4b5d-a237-a56b2fd18c75</SiteID>
  <RowType>1</RowType>
  <PrincipalName>sample string 1</PrincipalName>
  <PrincipalType>1</PrincipalType>
  <RowName>sample string 2</RowName>
  <CreateText>sample string 3</CreateText>
  <ReadText>sample string 4</ReadText>
  <UpdateText>sample string 5</UpdateText>
  <DeleteText>sample string 6</DeleteText>
  <DelegateText>sample string 7</DelegateText>
</Permission>

application/json, text/json

Sample

{
  "ID": "c1cdf056-25b2-4a93-8ab4-27b910d138ea",
  "RowID": "f00a39ea-ba83-4e30-a171-2df44176fc0f",
  "PrincipalID": "8e64ee0c-9352-48d7-8d8f-88028a8ab982",
  "ChildType": 1,
  "CreateState": 1,
  "ReadState": 1,
  "UpdateState": 1,
  "DeleteState": 1,
  "DelegateState": 1,
  "SiteID": "851de882-1dd0-4b5d-a237-a56b2fd18c75",
  "RowType": 1,
  "PrincipalName": "sample string 1",
  "PrincipalType": 1,
  "RowName": "sample string 2",
  "CreateText": "sample string 3",
  "ReadText": "sample string 4",
  "UpdateText": "sample string 5",
  "DeleteText": "sample string 6",
  "DelegateText": "sample string 7"
}

Name	Description
ID `globally unique identifier` Required on Update ID of the permission.	`globally unique identifier` Required on Update ID of the permission.
RowID `globally unique identifier` Required on Create ID of the object to be secured.	`globally unique identifier` Required on Create ID of the object to be secured.
PrincipalID `globally unique identifier` Required on Create User ID or Security Group ID for the permission.	`globally unique identifier` Required on Create User ID or Security Group ID for the permission.
ChildType `integer` Required on Create Type of the child permissions. Possible childtypes are: Null = Top level security, department(19), dialog(9, 25, 38), metric(7, 16, 58), organization(4), project(15). All other numbers will be treated as null.	`integer` Required on Create Type of the child permissions. Possible childtypes are: Null = Top level security, department(19), dialog(9, 25, 38), metric(7, 16, 58), organization(4), project(15). All other numbers will be treated as null.
CreateState `integer` Required Create security setting for the given object.	`integer` Required Create security setting for the given object.
ReadState `integer` Required Read security settings for the given object.	`integer` Required Read security settings for the given object.
UpdateState `integer` Required Update security settings for the given object.	`integer` Required Update security settings for the given object.
DeleteState `integer` Required Delete security settings for the given object.	`integer` Required Delete security settings for the given object.
DelegateState `integer` Required Delegate security settings for the given object.	`integer` Required Delegate security settings for the given object.
SiteID `globally unique identifier` ReadOnly ID of the given site.	`globally unique identifier` ReadOnly ID of the given site.
RowType `integer` ReadOnly Row type of the given object.	`integer` ReadOnly Row type of the given object.
PrincipalName `string` ReadOnly Name of the individual/security group for which to change/read security.	`string` ReadOnly Name of the individual/security group for which to change/read security.
PrincipalType `integer` ReadOnly Type of the individual/security group for which to change/read security.	`integer` ReadOnly Type of the individual/security group for which to change/read security.
RowName `string` ReadOnly Name of the object for which to change/read security.	`string` ReadOnly Name of the object for which to change/read security.
CreateText `string` ReadOnly Text value for CreateState; Not Set, Allow, Deny	`string` ReadOnly Text value for CreateState; Not Set, Allow, Deny
ReadText `string` ReadOnly Text value for ReadState; Not Set, Allow, Deny	`string` ReadOnly Text value for ReadState; Not Set, Allow, Deny
UpdateText `string` ReadOnly Text value for UpdateState; Not Set, Allow, Deny	`string` ReadOnly Text value for UpdateState; Not Set, Allow, Deny
DeleteText `string` ReadOnly Text value for DeleteState; Not Set, Allow, Deny	`string` ReadOnly Text value for DeleteState; Not Set, Allow, Deny
DelegateText `string` ReadOnly Text value for DelegateState; Not Set, Allow, Deny	`string` ReadOnly Text value for DelegateState; Not Set, Allow, Deny