Update the privileges for a role

patch/roles/{roleId}/privileges

Internal-Use Only

Updates the privileges of the role. Authorization: Requires the Manage Roles privilege and read access to the role context.

Request Samples

application/vnd.sas.clinical.privileges.update
1

Response Samples

200
application/vnd.sas.clinical.role
1{
2  "version": 1,
3  "createdBy": "sastest1",
4  "creationTimeStamp": "2023-09-26T15:46:09.962000Z",
5  "modifiedBy": "sastest1",
6  "modifiedTimeStamp": "2023-09-26T15:46:09.962000Z",
7  "id": "c39cf904-5dc5-4dab-b17e-f7960182feb0",
8  "typeId": "roleassignment",
9  "createdByDisplayName": "SAS Test User 1 (sastest1)",
10  "modifiedByDisplayName": "SAS Test User 1 (sastest1)",
11  "name": "taAdminRole",
12  "displayName": "taAdminRole",
13  "description": "Role for the therapeutic area administrator.",
14  "assignedContextId": "4437483c-dc7f-4512-986e-cde49d97d507",
15  "assignedContextTypeId": "therapeuticarea",
16  "definedContextId": "4437483c-dc7f-4512-986e-cde49d97d507",
17  "definedContextTypeId": "therapeuticarea",
18  "inherited": false
19}

Path Parameters

Name	Type	Required	Description
roleId	string	true	The unique identifier for the role. Examples: "d6eefec9-dcc2-4574-8af8-69897038d9c5"

Header Parameters

Name	Type	Required	Description
If-Match	string	true	The ETag that was returned from a GET, POST or PUT of a resource. Examples: "\"lgdxya1m\""

Request Body

The specification for privilege additions and removals.

The specification for updating role privileges.

Name	Type	Required	Description
version	number	false	The version of the representation. This is version 1.
addPrivileges	array [string]	false	The set of privilege IDs to add to the role.
removePrivileges	array [string]	false	The set of privilege IDs to remove from the role.

Responses

Status	Meaning	Description
200	OK	OK - the role was updated.	Schema
400	Bad Request	Bad request
404	Not Found	The role could not be found.
412	Precondition Failed	The ETag provided does not match the current resource.	Schema
428	Precondition Required	The request headers did not include a `If-Match` precondition.	Schema