GroupsManager

• List groups for enterprise
• Create group
• Get group
• Update group
• Remove group

List groups for enterprise

Retrieves all of the groups for a given enterprise. The user must have admin permissions to inspect enterprise's groups.

This operation is performed by calling function getGroups.

See the endpoint docs at API Reference.

try await client.groups.getGroups()

Arguments

• queryParams GetGroupsQueryParams
  • Query parameters of getGroups method
• headers GetGroupsHeaders
  • Headers of getGroups method

Returns

This function returns a value of type Groups.

Returns a collection of group objects. If there are no groups, an empty collection will be returned.

Create group

Creates a new group of users in an enterprise. Only users with admin permissions can create new groups.

This operation is performed by calling function createGroup.

See the endpoint docs at API Reference.

try await client.groups.createGroup(requestBody: CreateGroupRequestBody(name: groupName, description: groupDescription))

Arguments

• requestBody CreateGroupRequestBody
  • Request body of createGroup method
• queryParams CreateGroupQueryParams
  • Query parameters of createGroup method
• headers CreateGroupHeaders
  • Headers of createGroup method

Returns

This function returns a value of type GroupFull.

Returns the new group object.

Get group

Retrieves information about a group. Only members of this group or users with admin-level permissions will be able to use this API.

This operation is performed by calling function getGroupById.

See the endpoint docs at API Reference.

try await client.groups.getGroupById(groupId: group.id, queryParams: GetGroupByIdQueryParams(fields: ["id", "name", "description", "group_type"]))

Arguments

• groupId String
  • The ID of the group. Example: "57645"
• queryParams GetGroupByIdQueryParams
  • Query parameters of getGroupById method
• headers GetGroupByIdHeaders
  • Headers of getGroupById method

Returns

This function returns a value of type GroupFull.

Returns the group object.

Update group

Updates a specific group. Only admins of this group or users with admin-level permissions will be able to use this API.

This operation is performed by calling function updateGroupById.

See the endpoint docs at API Reference.

try await client.groups.updateGroupById(groupId: group.id, requestBody: UpdateGroupByIdRequestBody(name: updatedGroupName))

Arguments

• groupId String
  • The ID of the group. Example: "57645"
• requestBody UpdateGroupByIdRequestBody
  • Request body of updateGroupById method
• queryParams UpdateGroupByIdQueryParams
  • Query parameters of updateGroupById method
• headers UpdateGroupByIdHeaders
  • Headers of updateGroupById method

Returns

This function returns a value of type GroupFull.

Returns the updated group object.

Remove group

Permanently deletes a group. Only users with admin-level permissions will be able to use this API.

This operation is performed by calling function deleteGroupById.

See the endpoint docs at API Reference.

try await client.groups.deleteGroupById(groupId: group.id)

Arguments

• groupId String
  • The ID of the group. Example: "57645"
• headers DeleteGroupByIdHeaders
  • Headers of deleteGroupById method

Returns

This function returns a value of type ``.

A blank response is returned if the group was successfully deleted.