Skip to main content

Create a new group

POST 

<your-unleash-url>/api/admin/groups

Create a new user group for Role-Based Access Control

Request

Bodyrequired

createGroupSchema

    namestringrequired

    The name of the group

    Example: DX team
    descriptionstringnullable

    A custom description of the group

    Example: Current members of the DX squad
    mappingsSSOstring[]

    A list of SSO groups that should map to this Unleash group

    Example: ["SSOGroup1","SSOGroup2"]
    rootRolenumbernullable

    A role id that is used as the root role for all users in this group. This can be either the id of the Viewer, Editor or Admin role.

    Example: 1
    users object[]

    A list of users belonging to this group

  • Array [
  • user objectrequired

    A minimal user object

    idintegerrequired

    The user id

    Example: 123
  • ]

Responses

The resource was successfully created.

Response Headers
    location

    The location of the newly created resource.

Schema
    idinteger

    The group id

    Example: 1
    namestringrequired

    The name of the group

    Example: DX team
    descriptionstringnullable

    A custom description of the group

    Example: Current members of the DX squad
    mappingsSSOstring[]

    A list of SSO groups that should map to this Unleash group

    Example: ["SSOGroup1","SSOGroup2"]
    rootRolenumbernullable

    A role id that is used as the root role for all users in this group. This can be either the id of the Viewer, Editor or Admin role.

    Example: 1
    createdBystringnullable

    A user who created this group

    Example: admin
    createdAtdate-timenullable

    When was this group created

    Example: 2023-06-30T11:41:00.123Z
    users object[]

    A list of users belonging to this group

  • Array [
  • joinedAtdate-time

    The date when the user joined the group

    Example: 2023-06-30T11:41:00.123Z
    createdBystringnullable

    The username of the user who added this user to this group

    Example: admin
    user objectrequired

    An Unleash user

    idintegerrequired

    The user id

    Example: 123
    isAPIbooleandeprecated

    Deprecated in v5. Used internally to know which operations the user should be allowed to perform

    Example: true
    namestringnullable

    Name of the user

    Example: User
    emailstring

    Email of the user

    Example: user@example.com
    usernamestringnullable

    A unique username for the user

    Example: hunter
    imageUrlstring

    URL used for the user profile image

    Example: https://example.com/242x200.png
    inviteLinkstring

    If the user is actively inviting other users, this is the link that can be shared with other users

    Example: http://localhost:4242/invite-link/some-secret
    loginAttemptsinteger

    How many unsuccessful attempts at logging in has the user made

    Example: 3
    emailSentboolean

    Is the welcome email sent to the user or not

    Example: false
    rootRoleinteger

    Which root role this user is assigned

    Example: 1
    seenAtdate-timenullable

    The last time this user logged in

    Example: 2023-06-30T11:42:00.345Z
    createdAtdate-time

    The user was created at this time

    Example: 2023-06-30T11:41:00.123Z
    accountTypestring

    A user is either an actual User or a Service Account

    Example: User
    permissionsstring[]

    Deprecated

    scimIdstringnullable

    The SCIM ID of the user, only present if managed by SCIM

    Example: 01HTMEXAMPLESCIMID7SWWGHN6
    activeSessionsintegernullable

    Count of active browser sessions for this user

    Example: 2
    deletedSessionsnumber

    Experimental. The number of deleted browser sessions after last login

    Example: 1
  • ]
  • projectsstring[]

    A list of projects where this group is used

    Example: ["default","my-project"]
    userCountinteger

    The number of users that belong to this group

    Example: 1
    scimIdstringnullable

    The SCIM ID of the group, only present if managed by SCIM

    Example: 01HTMEXAMPLESCIMID7SWWGHN7

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API
curl -L '<your-unleash-url>/api/admin/groups' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: <Authorization>' \
-d '{
"name": "DX team",
"description": "Current members of the DX squad",
"mappingsSSO": [
"SSOGroup1",
"SSOGroup2"
],
"rootRole": 1,
"users": [
{
"user": {
"id": 123
}
}
]
}'
Request Collapse all
Base URL
<your-unleash-url>
Auth
Body required
{
  "name": "DX team",
  "description": "Current members of the DX squad",
  "mappingsSSO": [
    "SSOGroup1",
    "SSOGroup2"
  ],
  "rootRole": 1,
  "users": [
    {
      "user": {
        "id": 123
      }
    }
  ]
}
ResponseClear

Click the Send API Request button above and see the response here!