POST /tenant-management/api/system/tenants/{tenant}/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 specified tenant with the properties specified in JSON format in the request body.

Required user role: YUUVIS_SYSTEM_INTEGRATOR

The properties for the new role are passed in JSON format.

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


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


POST /tenant-management/api/system/tenants/mytenant/roles HTTP/1.1

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