List users affected by moving a group
GET https://{{host}}/identity-management/v3/user-admin/groups/move/:sourceGroupId/:destinationGroupId/affected-users
This operation lists users who are affected when you move a group. Users may lose or gain access to resources depending on the roles and permissions inherited from the new parent group. Users with a userType of lostAccess lose their access to the source group. If the userType is gainAccess, they gain access to the resources in the source group. Users who have inherited access to a group lose access to that group if it moves out of its hierarchy that gives them those access rights. If the group moves to another parent group to which they have access, they still have access to the group you move. Likewise, when you move a group to a new location, users who inherit their access rights from the new parent group gain access to the resources in the group you move.
Body
PARAM
| Key | Datatype | Required | Description |
userType
|
string | (Optional) __Enum__ Filters the list by users who have `lostAccess` or the reverse `gainAccess`. | |
accountSwitchKey
|
string | (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys). |
HEADERS
| Key | Datatype | Required | Description |
Accept
|
string |
RESPONSES
status OK
| [
{
"accountId": "A-CCT7890",
"email": "jsmith@example.com",
"firstName": "John",
"lastLoginDate": "2017-08-03T21:15:27.000Z",
"lastName": "Smith",
"uiIdentityId": "A-B-12345",
"uiUserName": "jsmith@example.com"
},
{
"accountId": "A-CCT1234",
"email": "jkowalski@example.com",
"firstName": "Jan",
"lastLoginDate": "2016-09-07T00:00:00.000Z",
"lastName": "Kowalski",
"uiIdentityId": "1-2A3BCD",
"uiUserName": "jkowalski@example.com"
}
] |
ENDPOINTS