> ## 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.

# PFGroupsDeleteGroupAsync

> Deletes a group and all roles, invitations, join requests, and blocks associated with it.

Deletes a group and all roles, invitations, join requests, and blocks associated with it.

## Syntax

```cpp theme={null}
HRESULT PFGroupsDeleteGroupAsync(  
    PFEntityHandle entityHandle,  
    const PFGroupsDeleteGroupRequest* request,  
    XAsyncBlock* async  
)  
```

### Parameters

**`entityHandle`**   PFEntityHandle

PFEntityHandle to use for authentication.

**`request`**   [PFGroupsDeleteGroupRequest\*](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsdeletegrouprequest)

Populated request object.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock for the async operation.

### Return value

Type: HRESULT

Result code for this API operation.

## Remarks

This API is available on all platforms. Deletes a group and all roles, invitations, join requests, and blocks associated with it. Permission to delete is only required the group itself to execute this action. The group and data cannot be cannot be recovered once removed, but any abuse reports about the group will remain. No data is returned in the case of success. See also GroupCreateGroupAsync. Call XAsyncGetStatus to get the status of the operation. If the service call is unsuccessful, the async result will be one of global PlayFab Service errors. See doc page "Handling PlayFab Errors" for more details on error handling.

## Requirements

**Header:** PFGroups.h

## See also

[PFGroups members](/services/playfab/api-references/c/pfgroups/pfgroups_members)