User groups

User Groups

Get User Group using User Group Id

URL

GET https://tools.deepen.ai/api/v2/user_groups/{user_group_id}

Request

Path parameters

Parameter name	Parameter type	Description
user_group_id	string	Id of the user group

Response

Returns an instance of UserGroupResource

Update User Group using User Group Id

URL

POST https://tools.deepen.ai/api/v2/user_groups/{user_group_id}

Request

Path parameters

Parameter name	Parameter type	Description
user_group_id	string	Id of the user group

Request body

Property name	Property type	Description
user_group_name	string	Name of the User Group
emails	array	Array of user emails to be updated

Example body

{ "user_group_name": "TestUserGroup", "emails": ["[e-mail]", "[e-mail]"], }

Response

Returns an empty response on successful completion.

Delete User Group using User Group Id

URL

DELETE https://tools.deepen.ai/api/v2/user_groups/{user_group_id}

Request

Path parameters

Parameter name	Parameter type	Description
user_group_id	string	Id of the user group

Response

Returns an empty response on successful deletion.

Get User Groups for a Client

URL

GET https://tools.deepen.ai/api/v2/clients/{client_id}/user_groups

Request

Path parameters

Parameter name	Parameter type	Description
client_id	string	Id of the client

Response

Returns an object with “user_groups” as key and the value as an array of instances of UserGroupResource

Create a User Group

URL

POST https://tools.deepen.ai/api/v2/clients/{client_id}/user_groups

Request

Path parameters

Parameter name	Parameter type	Description
client_id	string	Id of the client

Request body

Property name	Property type	Description
user_group_name	string	Name of the User Group
emails	array	Array of user emails to be updated

Example body

{ "user_group_name": "TestUserGroup", "emails": ["[e-mail]", "[e-mail]"], }

Response

Returns a json response with “user_group_id” as the key and the id of the newly created user group as the value.