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

# App Store Connect API 4.1 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.1 provides resources that enable you to automate actions you take in App Store Connect.

### New Features

- You can now use [Build uploads](/documentation/AppStoreConnectAPI/build-uploads) to upload and manage build uploads for your apps.
- You can now use the [App tags](/documentation/AppStoreConnectAPI/app-tags) resource to review the Apple created app tags for your app and opt out of certain app tags. To learn more, see [Manage app tags](https://developer.apple.com/help/app-store-connect/manage-app-information/manage-app-tags).
- Background assets has three new webhook event types for background assets, `BACKGROUND_ASSET_VERSION_INTERNAL_BETA_RELEASE_CREATED`, `BACKGROUND_ASSET_VERSION_EXTERNAL_BETA_RELEASE_STATE_UPDATED`, and `BACKGROUND_ASSET_VERSION_APP_STORE_RELEASE_STATE_UPDATED`. To learn more, see [Understanding webhook events](/documentation/AppStoreConnectAPI/webhook-events).
- [Webhook notifications](/documentation/AppStoreConnectAPI/webhook-notifications) now includes events for build uploads and build beta details. To learn more see, [Configuring and parsing App Store Connect API webhook notifications](/documentation/AppStoreConnectAPI/configuring-webhook-notifications) and [Understanding webhook events](/documentation/AppStoreConnectAPI/webhook-events).
- You can now use composite or sequential checksum on upload of asset packs. Checksums are not required for upload. For more information about these assets, see [Uploading and versioning Apple hosted background assets](/documentation/AppStoreConnectAPI/managing-apple-hosted-background-assets).
- You can now use the resource `backgroundAssetVersionExternalBetaReleases` to manage asset packs for external betas, and `backgroundAssetVersionAppStoreReleases` to manage asset packs for App store releases. To learn more, see [Background assets](/documentation/AppStoreConnectAPI/background-assets).
- You can now read age ratings per territory by using [`List Territory Age Ratings for an App Info`](/documentation/AppStoreConnectAPI/GET-v1-appInfos-_id_-territoryAgeRatings).

### Improvements

- The attribute `platform` is no longer required when using [`Create a Review Submission`](/documentation/AppStoreConnectAPI/POST-v1-reviewSubmissions). You can optionally add the attribute `platform` when using [`Modify a Review Submission`](/documentation/AppStoreConnectAPI/PATCH-v1-reviewSubmissions-_id_).
- The attribute `streamlinedPurchasingEnabled` has a default value of `true` for the object [`App.Attributes`](/documentation/AppStoreConnectAPI/App/Attributes-data.dictionary).
- The attribute `APPLE_VISION_PRO` is now documented for [`Device.Attributes`](/documentation/AppStoreConnectAPI/Device/Attributes-data.dictionary).
- The attributes `baDownloadAllowance` and `baMaxInstallSize` are now documented for [`BuildBundle.Attributes`](/documentation/AppStoreConnectAPI/BuildBundle/Attributes-data.dictionary).
- The attributes `usesNonExemptEncryption` and `computedMinVisionOsVersion` are now documented for [`Build.Attributes`](/documentation/AppStoreConnectAPI/Build/Attributes-data.dictionary).
- The filter `buildAudienceType` is now available for [`List prerelease versions`](/documentation/AppStoreConnectAPI/GET-v1-preReleaseVersions).
- The attribute `masked` is now available for [`BuildIcon.Attributes`](/documentation/AppStoreConnectAPI/BuildIcon/Attributes-data.dictionary). This boolean value that returns true if an icon has Liquid Glass treatment applied.

### Deprecations

- The attributes for [`AgeRatingDeclaration.Attributes`](/documentation/AppStoreConnectAPI/AgeRatingDeclaration/Attributes-data.dictionary), `INFREQUENT_OR_MILD` and `FREQUENT_OR_INTENSE` are deprecated. When you [`Modify an age rating declaration`](/documentation/AppStoreConnectAPI/PATCH-v1-ageRatingDeclarations-_id_), use the values use `INFREQUENT` or `FREQUENT` to update the age rating declarations for your app.
- The `sourceFileChecksum` attribute is deprecated for [`Commit an Uploaded Asset Pack to a Background Asset Version`](/documentation/AppStoreConnectAPI/PATCH-v1-backgroundAssetUploadFiles-_id_). Use `sourceFileChecksums` with the new [`Checksums`](/documentation/AppStoreConnectAPI/Checksums) type instead.

### Removals

- The `allowedDurations` properties is now removed from [`Create a Challenge`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterChallenges) and [`Modify a Challenge`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterChallenges-_id_).

---

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)