<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-store-connect-api-4-6-release-notes",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "App Store Connect API 4.6 release notes"
}
-->

# App Store Connect API 4.6 release notes

Update your server-side code to use new features, and test your code against API changes.

## Discussion

App Store Connect API version 4.6 provides resources that enable you to automate actions you take in App Store Connect.

## Added

- Give people a reason to stay subscribed when they start to cancel an auto-renewable subscription. Create a retention message with [`Create a retention message`](/documentation/AppStoreConnectAPI/POST-v1-retentionMessages), add localized text to its versions with [`Create a retention message localization`](/documentation/AppStoreConnectAPI/POST-v1-retentionMessageLocalizations), and present a discount alongside the message with [`Create a retention offer`](/documentation/AppStoreConnectAPI/POST-v1-retentionOffers). Assign the message to a subscription with [`Replace the retention message for a subscription`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptions-_id_-relationships-retentionMessage). For more information, see [Setting up retention messaging for auto-renewable subscriptions](/documentation/AppStoreConnectAPI/setting-up-retention-messaging).

## Deprecated

- The `INSTALLS` report type for [`Download sales and trends reports`](/documentation/AppStoreConnectAPI/GET-v1-salesReports) is deprecated. As of November 4, 2026, Apple no longer generates new reports of this type, but you can still download historical reports.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)