POST
/{orgId}/{itemId}/community/roles/{roleName}
Create or update a role with new privileges and groups. The new input values will replace any existing values defined for the role. Privileges are associated to roles and then those roles are associated to groups in the organization. This association permits or restricts application functionality based on what groups a user is a members of. The adminAdvanced privilege is required.
Query parameters
Name | Type | Required |
---|---|---|
token | string¦null |
Body parameters
Supported content types: application/json
Type: Role
A role object defining the role
Name | Type | Required |
---|---|---|
role | string¦null | |
description | string¦null | |
privileges | [string] |
Path parameters
Name | Type | Required |
---|---|---|
role | string | |
org | string | |
item | string |
Response status
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | success | Success |
400 | Bad Request | invalid role | WorkflowJsonExceptionDTO |
Examples
Request
# You can also use wget
curl -X POST /{orgId}/{itemId}/community/roles/{roleName} \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <YOUR_TOKEN>' \
--data '{"roleName":"string","description":"string","privileges":["string"]}'
Response
{
"success": true
}