App Store Connect API 4.1 release notes

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

Overview

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

You can now use Build uploads to upload and manage build uploads for your apps.
You can now use the 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.
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.
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 and Understanding 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.
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.
You can now read age ratings per territory by using List territory age ratings for an app info.

The attribute platform is no longer required when using Create a review submission. You can optionally add the attribute platform when using Modify a review submission.
The attribute streamlinedPurchasingEnabled has a default value of true for the object App.Attributes.
The attribute APPLE_VISION_PRO is now documented for Device.Attributes.
The attributes baDownloadAllowance and baMaxInstallSize are now documented for BuildBundle.Attributes.
The attributes usesNonExemptEncryption and computedMinVisionOsVersion are now documented for Build.Attributes.
The filter buildAudienceType is now available for List Prerelease Versions.
The attribute masked is now available for BuildIcon.Attributes. This boolean value that returns true if an icon has Liquid Glass treatment applied.

The attributes for AgeRatingDeclaration.Attributes, INFREQUENT_OR_MILD and FREQUENT_OR_INTENSE are deprecated. When you Modify an Age Rating Declaration, 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. Use sourceFileChecksums with the new Checksums type instead.

The allowedDurations properties is now removed from Create a challenge and Modify a challenge.