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>bc323bea-59da-4d54-ba15-562379b3c338</ID>
  <RowID>f0b29cf7-af3b-4d13-9311-bc1c64e43da7</RowID>
  <PrincipalID>0bed8b4c-2c67-40f2-92cc-85470244024c</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": "bc323bea-59da-4d54-ba15-562379b3c338",
  "RowID": "f0b29cf7-af3b-4d13-9311-bc1c64e43da7",
  "PrincipalID": "0bed8b4c-2c67-40f2-92cc-85470244024c",
  "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>e5781c6c-cb91-4fbe-b7e1-cbd5d2e88061</ID>
  <RowID>12ab2540-b527-43fc-af58-af0b43fc70fc</RowID>
  <PrincipalID>70f0eda3-2c93-4d5f-a02c-b2c902440bab</PrincipalID>
  <ChildType>1</ChildType>
  <CreateState>1</CreateState>
  <ReadState>1</ReadState>
  <UpdateState>1</UpdateState>
  <DeleteState>1</DeleteState>
  <DelegateState>1</DelegateState>
  <SiteID>175085f1-3008-4e8f-a2c4-e4b218be5d20</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": "e5781c6c-cb91-4fbe-b7e1-cbd5d2e88061",
  "RowID": "12ab2540-b527-43fc-af58-af0b43fc70fc",
  "PrincipalID": "70f0eda3-2c93-4d5f-a02c-b2c902440bab",
  "ChildType": 1,
  "CreateState": 1,
  "ReadState": 1,
  "UpdateState": 1,
  "DeleteState": 1,
  "DelegateState": 1,
  "SiteID": "175085f1-3008-4e8f-a2c4-e4b218be5d20",
  "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