Platform API

GetPermissionMatrix

Get a value for the current permission and object. Including the relevant data that affects the permission value outcome.

The following routes are available for this service:
All Verbs	/api/permissions/{PermissionId}/matrix/

**GetPermissionMatrix** Parameters:
Name	Parameter	Data Type	Required	Description
PermissionId	path	Guid	Yes	Permission Id to retrieve matrix for.
ObjectId	query	Guid	Yes	Object Id to retrieve permissions for. This will be either a contact, role list item or licensee contact.

**GetPermissionMatrixResponse** Parameters:
Name	Parameter	Data Type	Required
PermissionLevelValue	form	bool	No
PermissionsMatrix	form	List<PermissionLevelModel>	No
ResponseStatus	form	ResponseStatus	No

**PermissionLevelModel** Parameters:
Name	Parameter	Data Type	Required
PermissionValueId	form	Guid?	No
ObjectId	form	Guid	No
ObjectName	form	string	No
ObjectGroup	form	string	No
ContactsAffected	form	int	No
PermissionValue	form	bool?	No

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

HTTP + CSV

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

POST /api/permissions/{PermissionId}/matrix/ HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"PermissionId":"00000000-0000-0000-0000-000000000000","ObjectId":"00000000-0000-0000-0000-000000000000"}

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

{"PermissionLevelValue":false,"PermissionsMatrix":[{"PermissionValueId":"00000000000000000000000000000000","ObjectId":"00000000-0000-0000-0000-000000000000","ObjectName":"String","ObjectGroup":"String","ContactsAffected":0,"PermissionValue":false}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}