POST /tenant-management/api/admin/roles

Owned by Technische Redaktion
Nov 12, 2021
1 min read
As of Versionproduct version 2021 Autumn | component version 1.0
Request MethodPOST
Response FormatJSON
Description

Creates a new role for the tenant with the properties specified in the JSON request body.

Required user role: YUUVIS_TENANT_ADMIN

The only required parameters are name for the role and its description.


Meaning of the response status codes:
HTTP Status CodeMeaning
201 CREATEDSuccessful, the user has been created with the specified properties.
401 UNAUTHORIZEDThe call was unauthorized.
Request Example

POST /tenant-management/api/admin/roles HTTP/1.1

{
  "description": "This is a new role",
  "name": "MY_NEW_ROLE"
}
Response Example
{
  "errors": [],
  "valid": true
}