> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFGroupsChangeMemberRoleRequest

> PFGroupsChangeMemberRoleRequest data model. Changes the role membership of a list of entities from one role to another in a single operation.

PFGroupsChangeMemberRoleRequest data model. Changes the role membership of a list of entities from one role to another in a single operation. The destination role must already exist. This is equivalent to adding the entities to the destination role and removing from the origin role. Returns nothing if successful.

## Syntax

```cpp theme={null}
typedef struct PFGroupsChangeMemberRoleRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* destinationRoleId;  
    PFEntityKey const* group;  
    PFEntityKey const* members;  
    uint32_t membersCount;  
    const char* originRoleId;  
} PFGroupsChangeMemberRoleRequest;  
```

### Members

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(Optional) The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

**`customTagsCount`**   uint32\_t

Count of customTags

**`destinationRoleId`**   const char\*<br />*is null-terminated*

(Optional) The ID of the role that the entities will become a member of. This must be an existing role. Role IDs must be between 1 and 64 characters long.

**`group`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

The identifier of the group.

**`members`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

List of entities to move between roles in the group. All entities in this list must be members of the group and origin role.

**`membersCount`**   uint32\_t

Count of members

**`originRoleId`**   const char\*<br />*is null-terminated*

The ID of the role that the entities currently are a member of. Role IDs must be between 1 and 64 characters long.

## Requirements

**Header:** PFGroupsTypes.h

## See also

[PFGroupsTypes members](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsChangeMemberRoleAsync](/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [Services C API overview - PFGroupsTypes.h](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [members_role_updated](/services/playfab/api-references/events/Groups/members-role-updated.md)
- [PFGroupsListGroupMembersRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupmembersrequest.md)
- [PFGroupsCreateGroupRoleRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)