POST /tenant-management/api/system/tenants/{tenant}/roles

Owned by Team Kolibri (Unlicensed)
Last updated: May 10, 2022 by Technische Redaktion
As of Versionproduct version 2021 Autumn | component version 1.0
Request MethodPOST
Response FormatJSON
Required Permission

Available if listed in authorization.accesses in authentication-prod.yml and the specified access condition is matched. In the default configuration, access is granted via the YUUVIS_SYSTEM_INTEGRATOR role.

>> AUTHENTICATION Service
Description

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

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
}