Create a new role

post/roles

Adds a new role.

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

Request Samples

1

Response Samples

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

Query Parameters

NameTypeRequiredDescription
contextId
string
true

The ID of the context for which to get the assigned roles.

name
string
true

The name of the role.

description
string
false

The description of the role.

Responses

StatusMeaningDescription
201Created

The request succeeded and the created role is returned.

HeadersSchema
400Bad Request

Bad Request