Group - Creates a group for a tenant

Creates a new group under a specific tenant.

POST/tenants/{tenantId}/groups

Authorization

Bearer

Path parameters

tenantId*string (uuid)

Enter the ID of the existing tenant under which a new group will be created.

Query parameters

Body

application/jsontext/jsonapplication/*+json

displayNamenullable string

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the DisplayName property.

descriptionnullable string

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the Description property.

roleIdnullable string (uuid)

A public property of type guid that has both a getter and a setter method, which allows for getting and setting the value of the GroupId property.

Response

201500

Success: The group was successfully created.

Body

text/plainapplication/jsontext/json

groupIdstring (uuid)

A public property of type guid that has both a getter and a setter method, which allows for getting and setting the value of the GroupId property.

tenantIdstring (uuid)

A public property of type guid that has both a getter and a setter method, which allows for getting and setting the value of the TenantId property.

roleIdnullable string (uuid)

A public property of type guid that has both a getter and a setter method, which allows for getting and setting the value of the GroupId property.

displayNamenullable string

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the DisplayName property.

descriptionnullable string

A public property of type string that has both a getter and a setter method, which allows for getting and setting the value of the Description property.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/tenants/{tenantId}/groups', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201500

{
  "groupId": "123e4567-e89b-12d3-a456-426614174000",
  "tenantId": "123e4567-e89b-12d3-a456-426614174000",
  "roleId": "123e4567-e89b-12d3-a456-426614174000",
  "displayName": "text",
  "description": "text"
}