POST User Groups

POST User Groups

Create user group by importing already existing user group from external authentication server into Operations for Logs. Authentication server should be integrated with Operations for Logs beforehand.

Request
URI
POST
https://{api_host}/api/v1/user-groups
COPY
Request Body
user.groups.post.request of type(s) application/json
Optional 
{
    "provider": "ad",
    "domain": "vmware.com",
    "name": "test-allena",
    "roleIds": [
        "ebc6de0c-95c7-4faf-9490-9ba918d5faab",
        "00000000-0000-0000-0000-000000000001"
    ]
}
Authentication
This operation uses the following authentication methods.
Responses
201

Successfully created user group

Operation doesn't return any data structure

400

Incorrect request parameters

Operation doesn't return any data structure

401

The request was refused because it lacks valid authentication credentials. This can happen if the Authorization header was missing, or if it contained an invalid session ID.

Obtain a new session ID and retry the request, or make an unauthenticated request without the Authorization header.

"Invalid session ID"

404

Specified Active Directory or Workspace ONE Access group does not exist

Operation doesn't return any data structure

409

Specified user group already exists

Operation doesn't return any data structure

422

Workspace ONE Access or Active Directory configuration is not enabled

Operation doesn't return any data structure

440

The request was refused because the session ID has expired. Obtain a new session ID from /api/v1/sessions.

"Login Timeout"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/api/v1/user-groups
On This Page
User Groups Operations
GET
GET User Groups
POST
POST User Groups
GET
GET User Groups Provider
GET
GET User Groups Provider Domain Name
DELETE
DELETE User Groups Provider Domain Name
PATCH
PATCH User Groups Provider Domain Name