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

# PFGroupsUpdateGroupRoleRequest

> PFGroupsUpdateGroupRoleRequest data model. Updates the role name. Returns information about whether the update was successful.

PFGroupsUpdateGroupRoleRequest data model. Updates the role name. Returns information about whether the update was successful.

## Syntax

```cpp theme={null}
typedef struct PFGroupsUpdateGroupRoleRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    int32_t const* expectedProfileVersion;  
    PFEntityKey const* group;  
    const char* roleId;  
    const char* roleName;  
} PFGroupsUpdateGroupRoleRequest;  
```

### Members

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*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

**`expectedProfileVersion`**   int32\_t const\*\
*may be nullptr*

(Optional) Optional field used for concurrency control. By specifying the previously returned ProfileVersion value from the GetGroup API, you can ensure that the group role update is performed only if the group has not been updated since you last loaded that version. If the same group has been updated, the requested update will not occur and the returned SetResult value will be None.

**`group`**   [PFEntityKey](https://docs.xbox.com/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*

The identifier of the group.

**`roleId`**   const char\*\
*is null-terminated*

(Optional) ID of the role to update. Role IDs must be between 1 and 64 characters long.

**`roleName`**   const char\*\
*is null-terminated*

The new name of the role.

## Requirements

**Header:** PFGroupsTypes.h

## See also

[PFGroupsTypes members](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)


## Related topics

- [PFGroupsUpdateRoleAsync](https://docs.xbox.com/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [Services C API overview - PFGroupsTypes.h](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsUpdateGroupRequest](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprequest.md)
- [PFGroupsUpdateGroupRoleResponse](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouproleresponse.md)
- [PFGroupsCreateGroupRoleRequest](https://docs.xbox.com/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)