GET

Get request type permissions

Returns the permissions for a customer request type for a given request type ID. These permissions control who can create the customer request. The entities that can be granted permissions are users, groups, and organizations.

Request

Path parameters

serviceDeskId

string

Required
requestTypeId

string

Required

Responses

Returns the customer request type permissions.

application/json

RequestTypePermissionDTO
GET/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/permission
1 2 3 4 curl --request GET \ --url 'http://{baseurl}/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/permission' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 { "id": "<string>", "permissions": [ { "displayName": "<string>", "status": "DELETED", "avatarUrl": "<string>", "entityId": "<string>", "entityType": "USER" } ] }
PUT

Upsert request type permissions

Upsert the permissions for a customer request type. This operation will overwrite any existing permissions.

Request

Path parameters

serviceDeskId

string

Required
requestTypeId

string

Required

Request bodyapplication/json

The request type permissions to associate with customer request type.

allowlist

array<RequestTypePermissionEntityRequest>

Responses

Returns the updated customer request type permissions.

application/json

RequestTypePermissionDTO
PUT/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/permission
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 curl --request PUT \ --url 'http://{baseurl}/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype/{requestTypeId}/permission' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "allowlist": [ { "entityType": "ORGANIZATION", "entityId": "ORGANIZATION_ID" }, { "entityType": "GROUP", "entityId": "GROUP_NAME" }, { "entityType": "USER", "entityId": "USER_ID" } ] }'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 { "id": "<string>", "permissions": [ { "displayName": "<string>", "status": "DELETED", "avatarUrl": "<string>", "entityId": "<string>", "entityType": "USER" } ] }

Rate this page: