POST /tenant-management/api/admin/groups

As of Version product version 2021 Autumn | component version 1.0

Request Method POST

Response Format JSON

Description

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

Required user role: YUUVIS_TENANT_ADMIN

In the response, the group ID is returned again in JSON format.

The only required parameter is name for the group name. If roles should be assigned the given realmRoles must exist.

Meaning of the response status codes:

HTTP Status Code	Meaning
`201 CREATED`	Successful, the user has been created with the specified properties.
`401 UNAUTHORIZED`	The call was unauthorized.

Request Example

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

{
  "name": "QA",
  "realmRoles": [
    "QUALITY_MANAGER",
    "CUSTOM_ROLE"
  ]
}

Response Example

{
  "id": "a00a0bb1-1234-5c66-7890-00fbb1c1a222"
}