Read One Group Membership for User
GET {{apiPath}}/environments/{{envID}}/users/{{userID}}/memberOfGroups/{{groupID}}?expand=group
The GET /environments/{{envID}}/users/{{userID}}/memberOfGroups/{{groupID}}
operation returns one group that the specified user is a member of.
For more information about groups, see Groups.
Parameter | Description |
---|---|
expand (string) | Possible value is group . When this query parameter is appended to the request, the results are expanded to include additional information about the group. |
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
expand | string |
RESPONSES
status: OK
{"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/c98fd0cc-c34b-406a-9e0b-a892edb7a702/memberOfGroups/65631016-ecfc-4ba6-8cc0-bcc548eb58e2"},"user":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/c98fd0cc-c34b-406a-9e0b-a892edb7a702"},"environment":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"group":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/groups/65631016-ecfc-4ba6-8cc0-bcc548eb58e2"}},"_embedded":{"group":{"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/c98fd0cc-c34b-406a-9e0b-a892edb7a702/memberOfGroups/65631016-ecfc-4ba6-8cc0-bcc548eb58e2"},"environment":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"allUserMembers":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users?filter=memberOfGroups%5Bid%3D%2265631016-ecfc-4ba6-8cc0-bcc548eb58e2%22%5D"},"directUserMembers":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users?filter=memberOfGroups%5Bid%3D%2265631016-ecfc-4ba6-8cc0-bcc548eb58e2%22%20and%20type%20eq%20%22DIRECT%22%5D"}},"id":"65631016-ecfc-4ba6-8cc0-bcc548eb58e2","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"name":"Training","description":"This is a test group","customData":{"groupOwner":"Jane Doe","securityyGroup":false},"directMemberCounts":{"users":3},"createdAt":"2020-11-10T21:42:55.219Z","updatedAt":"2020-11-10T21:42:55.219Z"}},"id":"65631016-ecfc-4ba6-8cc0-bcc548eb58e2","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"name":"Training","type":"DIRECT"}