Skip to main content

Get users in a group

Log in to add to favourites
GET/api/security/groups/{groupIdentifier}/users?order={order}&pageIndex={pageIndex}&pageSize={pageSize}&includeInherited={includeInherited}&zenQL={zenQL}&excludedGroups={excludedGroups}

Parameters

NameParameter typeTypeFormatDescription
groupIdentifier(required)pathstringgroup identifier For convenience, Group resources can be referenced by using either the group name or id
orderquerystring-A comma-separated list of the field Ids to order the results by. Prefix field Id with - for descending order.
pageSizequerynumberintegerThe number of results per page. The default is 25.
pageIndexquerynumberintegerThe index of the page.
includeInheritedqueryboolean-Specify to include the users of all the descendant groups
zenqlquerystring-ZenQL query to select the users returned in the listing
excludedGroupsquerystring-A comma-separated list of group identifiers such as Guid ids or names whose children will be excluded from the returned values

Responses

HTTP status codeReasonModel
200SuccessUser
401UnauthorizedError
403ForbiddenError
404Group not foundError
500Internal server errorError

Examples

Get users in a group by Id

HTTP
GET: /api/security/groups/82f73a9b-2a13-4d63-bcc1-e8ee5047b01c/users

Get users in a named group

HTTP
GET: /api/security/groups/Paper%20Street%20Soap%20Company/users

Get the first page of users in a group and all the group's descendant groups, with page sizes of 10

HTTP
GET: /api/security/groups/82f73a9b-2a13-4d63-bcc1-e8ee5047b01c/users?pageIndex=0&pageSize=10&includeInherited=true

Get the first page of users in a group and all the group's descendant groups where the user's firstname contains 'test' and where their membership does not descend from the 'System Administrators' group.

HTTP
GET: /api/security/groups/82f73a9b-2a13-4d63-bcc1-e8ee5047b01c/users?includeInherited=true&zenQL=firstname~test&excludedGroups=System%20Administrators

Remarks

Permissions

Member of System Administrators.

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.
New support request