Create a new role

post/roles

Internal-Use Only

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

Request Samples

Response Samples

201
application/json
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}

Query Parameters

Name	Type	Required	Description
contextId	string	true	The ID of the context for which to get the assigned roles. Examples: "d6eefec9-dcc2-4574-8af8-69897038d9c5"
name	string	true	The name of the role. Examples: "Developers"
description	string	false	The description of the role. Examples: "This is a role description."

Responses

Status	Meaning	Description
201	Created	The request succeeded and the created role is returned.		Schema
400	Bad Request	Bad Request