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/v2/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"
]
}Responses
201
Retrieves successfully created user group
Returns
user.groups.post.get.patch.response
of type(s)
application/json
{
"userGroup": {
"provider": "ad",
"domain": "vmware.com",
"name": "directoryGroupName",
"roleIds": [
"a03f0db0-fc0b-4001-9c64-3cf0c7201741"
]
}
}
400
Incorrect request parameters
Operation doesn't return any data structure
401
Operation doesn't return any data structure
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
Operation doesn't return any data structure
Code Samples
COPY
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/api/v2/user-groups