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

# PFCatalogReviewItemAsync

> Creates or updates a review for the specified item. More information around the caching surrounding item ratings and reviews can be found here: https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/ratings#ratings-design-and-caching

Creates or updates a review for the specified item. More information around the caching surrounding item ratings and reviews can be found here: [https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/ratings#ratings-design-and-caching](https://learn.microsoft.com/gaming/playfab/features/economy-v2/catalog/ratings#ratings-design-and-caching)

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

PFEntityHandle to use for authentication.

**`request`**   [PFCatalogReviewItemRequest\*](https://docs.xbox.com/services/playfab/api-references/c/pfcatalogtypes/structs/pfcatalogreviewitemrequest.md)

Populated request object.

**`async`**   XAsyncBlock\*\
*Inout*

XAsyncBlock for the async operation.

### Return value

Type: HRESULT

Result code for this API operation.

## Remarks

This API is available on all platforms. Call XAsyncGetStatus to get the status of the operation. If the service call is unsuccessful, the async result will be E\_PF\_DATABASE\_THROUGHPUT\_EXCEEDED, E\_PF\_ITEM\_NOT\_FOUND or any of the global PlayFab Service errors. See doc page "Handling PlayFab Errors" for more details on error handling.

## Requirements

**Header:** PFCatalog.h

## See also

[PFCatalog members](https://docs.xbox.com/services/playfab/api-references/c/pfcatalog/pfcatalog_members.md)


## Related topics

- [Services C API overview - PFCatalog.h](https://docs.xbox.com/services/playfab/api-references/c/pfcatalog/pfcatalog_members.md)
- [PFCatalogGetItemReviewsAsync](https://docs.xbox.com/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsasync.md)
- [PFCatalogReportItemReviewAsync](https://docs.xbox.com/services/playfab/api-references/c/pfcatalog/functions/pfcatalogreportitemreviewasync.md)
- [PFCatalogTakedownItemReviewsAsync](https://docs.xbox.com/services/playfab/api-references/c/pfcatalog/functions/pfcatalogtakedownitemreviewsasync.md)
- [PFCatalogGetEntityItemReviewAsync](https://docs.xbox.com/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentityitemreviewasync.md)