Platform API

AddContactRole

Add a custom role for the licensee

The following routes are available for this service:
POST	/api/roles

**AddContactRole** Parameters:
Name	Parameter	Data Type	Required	Description
RoleDetails	query	RoleDetailsModel	Yes	Details of the Contact Role to be Added.

**RoleDetailsModel** Parameters:
Name	Parameter	Data Type	Required	Description
RoleId	form	Guid	No	Role Id
RoleName	form	string	No	Role Name
RoleConnectionDefinitionId	form	Guid	No	Role Connection Definition Id
ContactTypes	form	List	No	Contact Types the Role applies to
RequireContactsToAccept	form	bool	No	Does the role require contacts to accept it?
ListItemFilters	form	List	No	Filters linked to the custom role.

**ListItemFilterModel** Parameters:
Name	Parameter	Data Type	Required
ListItemFilterId	form	Guid	No
FilterName	form	string	No
ListId	form	Guid	No
ListItemId	form	Guid	No
ListItemIsInFilter	form	bool	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/roles HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	RoleDetails: 
	{
		RoleName: String,
		ContactTypes: 
		[
			00000000-0000-0000-0000-000000000000
		],
		RequireContactsToAccept: False,
		ListItemFilters: 
		[
			{
				FilterName: String,
				ListItemIsInFilter: False
			}
		]
	}
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	ErrorCode: String,
	Message: String,
	StackTrace: String,
	Errors: 
	[
		{
			ErrorCode: String,
			FieldName: String,
			Message: String,
			Meta: 
			{
				String: String
			}
		}
	],
	Meta: 
	{
		String: String
	}
}