HTTP - Management
Check a group has a user member
Created by c.neale, last modified by s.yearsley on 24 Sep 2020
A group can be checked to see if it has a user member using the following HEAD request. A 204 HTTP status response confirms membership, whereas a 404 HTTP status marks no membership.
If an invalid value for userIdentifier or any groupIdentifier is passed then a 400 HTTP status response will be returned.
HEAD/api/security/groups/{groupIdentifier}/users/{userIdentifier}
Parameters
| Name | Parameter type | Type | Format | Description | Example | Required |
|---|---|---|---|---|---|---|
| groupIdentifier | path | string | group identifier | For convenience, Group resources can be referenced by using either the group name or id | "Paper Street Soap Company" or "82f73a9b-2a13-4d63-bcc1-e8ee5047b01c" | true |
| UserIdentifier | path | string | user identifier | For convenience, User resources can be referenced by using one of several identifiers - username, email address or Id. | "82f73a9b-2a13-4d63-bcc1-e8ee5047b01c" or "t.durden" or "t.durden@fightclub.com" | true |
Examples
Check if a user is a member of the a group by Id
HEAD: /api/security/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251/users/9f02a3d1-d8eb-4b10-8ed6-293a11d5201fCheck if user 'tdurden' is a member of the 'Paper Street Soap Company' group by name
HEAD: /api/security/groups/Paper%20Street%20Soap%20Company/users/tdurdenCheck if user is a member of the 'Fight club' group by email address
HEAD: /api/security/groups/9bb89380-fd49-41a5-ab2f-fc25e482a251/users/tdurden@fightclub.comRemarks
Membership will be classed as true if the user is a member of a child group of the specified group.
Only a 'System Adminstrator' or the authenticated user matching the specified user can check group membership.