Create user group

Creates a new user group within the organization for organizing users and managing group-based permissions.

POST/organizations/{organizationName}/groups

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

organizationName*string

The unique identifier of the organization

Match^[a-zA-Z0-9_ -]+$

Request Body

application/json

Represents a user group for organizing users and managing group-based permissions

organizationName?IdentifierPattern

The name of the organization that owns this group

Match^[a-zA-Z0-9_ -]+$

groupName?GroupNamePattern

The unique identifier for the group within the organization

Match^(?!.*\*)(?!.*[/]).{1,70}$

description?string

Human-readable description of the group's purpose and membership

createdAt?string

ISO 8601 timestamp indicating when the group was created

Formatdate-time

updatedAt?string

ISO 8601 timestamp indicating when the group was last modified

Formatdate-time

Response Body

`application/json`

curl --request POST \  --url 'https://example.com/organizations/string/groups' \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{}'

{  "organizationName": "string",  "groupName": "string",  "description": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Create user group

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`