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

# PlayFab Services C/C++ SDK Release Notes

> Release notes index for the PlayFab Services C/C++ SDK (PlayFabCSdk), tracking SDK versions, new APIs, deprecations, and bug fixes across releases.

These release notes are for **PlayFabCSdk**. For release notes for other PlayFab Services SDKs, see [Other Services SDK Release Notes](https://docs.xbox.com/services/playfab/release-notes.md).

> [!NOTE]
>
> For release notes about service releases and product updates, see the [release notes](https://github.com/PlayFab/PlayFab/releases) section on [PlayFab's public GitHub repository](https://github.com/PlayFab/PlayFab)

## 2604.0.1

Date: September 4, 2026

### Breaking changes

* Removed `PFInventoryGetMicrosoftStoreAccessTokensAsync`, its result functions, and its request and response types after the service API was retired.
* Removed `PFSegmentsServerGetPlayersInSegmentAsync`, its result functions, and its supporting types after the service API was retired.
* Removed the obsolete `entity` member from `PFAuthenticationGetEntityRequest`. `PFAuthenticationGetEntityAsync` now issues a token for the calling entity.
* Renamed two Account Management request types to distinguish the Client and Server models:
  * `PFAccountManagementUnlinkAppleRequest` is now `PFAccountManagementClientUnlinkAppleRequest`.
  * `PFAccountManagementUnlinkGameCenterAccountRequest` is now `PFAccountManagementClientUnlinkGameCenterAccountRequest`.
* Removed the retired `E_PF_COPILOT_DISABLED`, `E_PF_COPILOT_INVALID_REQUEST`, `E_PF_GET_PLAYERS_IN_SEGMENT_DEPRECATED`, and `E_PF_GET_PLAYERS_IN_SEGMENT_RATE_LIMIT_EXCEEDED` error codes.
* Changed the underlying type of `PFGameSaveInitOptions` from `uint32_t` to `uint64_t`.
* Added values to `PFMultiplayerServerAzureVmSize`. Existing values after the insertion points have new numeric representations, so applications shouldn't persist or transmit the numeric value of this enumeration across SDK versions.

### API updates

* Added the optional `namespaceWide` member to `PFFriendsClientGetFriendsListRequest` and `PFFriendsServerGetFriendsListRequest`. It includes friends from the same namespace who haven't signed in to the current title.
* Added PlayStation Network authentication-version and sandbox support through new `authVersion`, `sandboxId`, and `psnSandboxId` members on the related Authentication, Account Management, and user-information models.
* Added `issuer` to `PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest`.
* Added statistics data to entity profiles through `includeStatistics` and the new `PFStatisticColumn`, `PFStatisticColumnCollection`, and `PFStatisticColumnCollectionDictionaryEntry` types.
* Added `aggregationTargetEntityKeys` to `PFStatisticsStatisticUpdate` and added the `PFStatisticAggregationMethod` enumeration.
* Added `expirationTimestamp` to `PFInventoryRedemptionSuccess`, `region` to `PFMultiplayerServerRequestPartyServiceResponse`, and additional Azure VM sizes.
* Added service error codes for new PlayStation Network, Nintendo, Economy, Experiments, Statistics, Segments, entity-membership, IP-address, and Game Save conditions.
* `PFEntityRegisterTokenRefreshedEventHandler` now accepts an optional task queue.
* Added `E_PF_GAMESAVE_OPERATION_IN_PROGRESS` for Game Save operations rejected because another mutually exclusive operation is in progress.
* Added `PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH`, which defines the maximum accepted short save-description length as 768 characters.

### Runtime and platform updates

* Fixed `PFUninitializeAsync` hanging while an internal HTTP operation or event-pipeline flush is in progress.
* Added the SDK version to the trace log during initialization.
* Updated `PlayFab::Wrappers::Exception::what()` to include the `HRESULT` in its message.
* Exported `PF_API` symbols with default visibility on iOS and macOS, and fixed a macOS launch crash when using the Apple Unified SDK.
* Fixed sized `operator delete` overrides on Clang-based toolchains so custom memory hooks are honored.
* Updated GDK projects to use the `x64` project platform required by the GDK 2510 layout and added support for retargeting projects to the Visual Studio 2026 `v145` toolset.
* Pinned the Android `com.google.android.gms:play-services-games-v2` dependency to version 21.0.0 to retain `minSdkVersion 21` compatibility.

### Game Save updates

* Fixed non-PlayFab blob-transfer failures being reported as success. HTTP failures now return a failing `HRESULT` instead of allowing a manifest to be finalized against a blob that wasn't written.
* Fixed data-loss and synchronization issues involving stale extended-manifest URLs, incomplete remote file sets, folder deletion during download, missing `localstate.json`, and marker-file creation for new saves.
* Fixed upload, locking, and conflict failures, including infinite relock loops, stale manifest versions, incorrect base-version chains, conflict-loser selection, mishandled nonretryable service errors, and unnecessarily slow uploads after directory deletion.
* Fixed GDK memory corruption and races in shared Game Save context management, and added validation that prevents extended-manifest paths from escaping the save folder.
* Restored title write access to the save folder when synchronization enters the `Uploading` state. Original files are read only during `PreparingForUpload`.
* Clarified progress behavior: `PFGameSaveFilesUiProgressCallback` reports state transitions, while `PFGameSaveFilesUiProgressGetProgress` can be polled for byte-level progress. A total of zero now means that the total is unknown.
* Fixed GRTS cancellation and offline behavior, accepted forward-slash paths produced by engines such as Unreal Engine, and corrected several Windows and GDK initialization, shutdown, device-identity, and save-loading failures.
* Fixed Game Save telemetry identifying Steam Deck devices incorrectly.

## 2504.0.0

Date: April 22, 2025

* Migrated JSON parsing from rapidjson to nlohmann::json for improved security and maintainability.
* Addressed an issue where initializing PFCore overwrites the trace callback set by the title.
* Changes to the memory hook functions, adding a new API to retrieve default memory hooks and modifying existing memory allocation functions to include a memory type ID.
* Fixed a bug related to tracing cleanup when multiple clients are involved.
* Enabled the PFAccountManagementSetDisplayNameAsync API in PlayFab.C.
* Introduced custom memory allocation for the nlohmann JSON library and global overrides for new/delete operators.

## 2410.0.0

Date: October 4, 2024

* Added public headers, source, and libraries for use with the Microsoft GDK to the GitHub release
* The http library, libHttpClient, is now a dynamic library dependency on all platforms. This library must be included in the game's shipped package for PlayFab Services to function.
* Added public preview APIs for Leaderboards and Statistics
* Added authenticationToken optional parameter authenticationToken to PFAuthenticationLoginWithFacebookRequest
* Added support for new service error codes
* Removed OfferId from redeem responses in the Economy API. Added the new field MarketplaceAlternateId instead. Callers should move to the new field, while the service will continue to respond with both fields for backward compatibility.
* Resolved an issue with PFFriendsExternalFriendSources not allowing multiple selections

## 2406.0.0

Date: July 2, 2024

* Added support for optional gzip compression to **PFEventPipelineConfig** for Linux and Android
* Added support for automatic response gzip compression (and decompression) using **PFHttpSettings**
* Enable print truncation when attempting to log XCurl traces
* Fixed various static code analysis warnings

## 2403.0.0

Date: February 28, 2024

* Release of new SDK projections with support for Linux, Android, iOS and macOS. The new APIs being exposed with this release are:
  * **For Android**:
    * LoginWithFacebook
    * ClientLinkGoogleAccount
    * ClientLinkGooglePlayGamesServicesAccount
    * ClientUnlinkGoogleAccount
    * ClientUnlinkGooglePlayGamesServicesAccount
    * ClientAndroidDevicePushNotificationRegistration
    * RedeemGooglePlayInventoryItems
  * **For iOS**:
    * LoginWithFacebook
    * ClientLinkApple
    * ClientUnlinkApple
    * ClientLinkGameCenterAccount
    * ClientUnlinkGameCenterAccount
    * ClientRegisterForIOSPushNotification
    * RedeemAppleAppStoreInventoryItems
* Added support for Event Buffering in Event pipelines.

## 2310.0.1

Date: September 28, 2023

* Added PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync to Win32

## 2310.0.0

Date: September 28, 2023

* Added support for Nintendo Switch (see Request access for secured SDKs and samples - PlayFab | Microsoft Learn to request access)
* Added optional gzip compressionLevel to **PFEventPipelineConfig**
* Removed TelemetryKey management calls from **PFEvents**
* Added missing Legacy **PFCloudScript** Client calls:
  * ClientExecuteCloudScript
  * ExecuteEntityCloudScript
* Added missing **PFAccountManagement** Client calls:
  * ClientAddOrUpdateContactEmail
  * ClientAddUsernamePassword
  * ClientGetPlayFabIDsFromFacebookIDs
  * ClientGetPlayFabIDsFromFacebookInstantGamesIds
  * ClientGetPlayFabIDsFromGameCenterIDs
  * ClientGetPlayFabIDsFromGoogleIDs
  * ClientGetPlayFabIDsFromGooglePlayGamesPlayerIDs
  * ClientGetPlayFabIDsFromKongregateIDs
  * ClientGetPlayFabIDsFromNintendoServiceAccountIds
  * ClientGetPlayFabIDsFromNintendoSwitchDeviceIds
  * ClientGetPlayFabIDsFromPSNAccountIDs
  * ClientGetPlayFabIDsFromTwitchIDs
  * ClientLinkAndroidDeviceID
  * ClientLinkApple
  * ClientLinkFacebookAccount
  * ClientLinkFacebookInstantGamesId
  * ClientLinkGameCenterAccount
  * ClientLinkGoogleAccount
  * ClientLinkGooglePlayGamesServicesAccount
  * ClientLinkIOSDeviceID
  * ClientLinkKongregate
  * ClientLinkNintendoServiceAccount
  * ClientLinkNintendoSwitchDeviceId
  * ClientLinkPSNAccount
  * ClientLinkTwitch
  * ClientRemoveContactEmail
  * ClientSendAccountRecoveryEmail
  * ClientUnlinkAndroidDeviceID
  * ClientUnlinkApple
  * ClientUnlinkFacebookAccount
  * ClientUnlinkFacebookInstantGamesId
  * ClientUnlinkGameCenterAccount
  * ClientUnlinkGoogleAccount
  * ClientUnlinkGooglePlayGamesServicesAccount
  * ClientUnlinkIOSDeviceID
  * ClientUnlinkKongregate
  * ClientUnlinkNintendoServiceAccount
  * ClientUnlinkNintendoSwitchDeviceId
  * ClientUnlinkPSNAccount
  * ClientUnlinkTwitch
  * ClientUpdateUserTitleDisplayName
* Added many calls intended for use by game servers (only for Win32)
  * **PFAuthentication**
    * ServerLoginWithServerCustomId
    * ServerLoginWithSteamId
    * ServerLoginWithXbox
    * ServerLoginWithXboxId
    * AuthenticateGameServerWithCustomId
    * Delete
    * GetEntity
    * ValidateEntityToken
  * **PFAccountManagement**
    * ServerBanUsers
    * ServerDeletePlayer
    * ServerGetPlayerCombinedInfo
    * ServerGetPlayerProfile
    * ServerGetPlayFabIDsFromFacebookIDs
    * ServerGetPlayFabIDsFromFacebookInstantGamesIds
    * ServerGetPlayFabIDsFromNintendoServiceAccountIds
    * ServerGetPlayFabIDsFromNintendoSwitchDeviceIds
    * ServerGetPlayFabIDsFromPSNAccountIDs
    * ServerGetPlayFabIDsFromSteamIDs
    * ServerGetPlayFabIDsFromTwitchIDs
    * ServerGetPlayFabIDsFromXboxLiveIDs
    * ServerGetServerCustomIDsFromPlayFabIDs
    * ServerGetUserAccountInfo
    * ServerGetUserBans
    * ServerLinkNintendoServiceAccount
    * ServerLinkNintendoSwitchDeviceId
    * ServerLinkPSNAccount
    * ServerLinkServerCustomId
    * ServerLinkSteamId
    * ServerLinkXboxAccount
    * ServerRevokeAllBansForUser
    * ServerRevokeBans
    * ServerSendCustomAccountRecoveryEmail
    * ServerSendEmailFromTemplate
    * ServerUnlinkNintendoServiceAccount
    * ServerUnlinkNintendoSwitchDeviceId
    * ServerUnlinkPSNAccount
    * ServerUnlinkServerCustomId
    * ServerUnlinkSteamId
    * ServerUnlinkXboxAccount
    * ServerUpdateAvatarUrl
    * ServerUpdateBans
    * GetTitlePlayersFromXboxLiveIDs
  * **PFCloudScript**
    * ServerExecuteCloudScript
  * **PFFriends**
    * ServerAddFriend
    * ServerGetFriendsList
    * ServerRemoveFriend
    * ServerSetFriendTags
  * **PFInventory**
    * GetTransactionHistory
  * **PFLocalization**
    * GetLanguageList
  * **PFPlatformSpecific**
    * ServerAwardSteamAchievement
  * **PFPlayerDataManagement**
    * ServerGetUserData
    * ServerGetUserInternalData
    * ServerGetUserPublisherData
    * ServerGetUserPublisherInternalData
    * ServerGetUserPublisherReadOnlyData
    * ServerGetUserReadOnlyData
    * ServerUpdateUserData
    * ServerUpdateUserInternalData
    * ServerUpdateUserPublisherData
    * ServerUpdateUserPublisherInternalData
    * ServerUpdateUserPublisherReadOnlyData
    * ServerUpdateUserReadOnlyData
  * **PFPushNotifications**
    * ServerSendPushNotification
    * ServerSendPushNotificationFromTemplate
  * **PFSegments**
    * ServerAddPlayerTag
    * ServerGetAllSegments
    * ServerGetPlayerSegments
    * ServerGetPlayersInSegment
    * ServerGetPlayerTags
    * ServerRemovePlayerTag
  * **PFTitleDataManagement**
    * ServerGetPublisherData
    * ServerGetTime
    * ServerGetTitleData
    * ServerGetTitleInternalData
    * ServerGetTitleNews
    * ServerSetPublisherData
    * ServerSetTitleData
    * ServerSetTitleInternalData

## 2306.0.0

Date: July 26, 2023

* Initial release of the SDK with support for Win32 and GDK


## Related topics

- [PlayFab Services SDK Release Notes 2025](https://docs.xbox.com/services/playfab/release-notes/2025.md)
- [PlayFab Services SDK Release Notes 2026](https://docs.xbox.com/services/playfab/release-notes/index.md)
- [PlayFab Services SDK Release Notes 2024](https://docs.xbox.com/services/playfab/release-notes/2024.md)
- [PlayFab Services SDK Release Notes 2023](https://docs.xbox.com/services/playfab/release-notes/2023.md)
- [PlayFab Multiplayer C++ SDK Release Notes](https://docs.xbox.com/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)