<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-store-version-phased-releases",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Store Version Phased Releases"
}
-->

# App Store Version Phased Releases

Manage phased releases of updates to your app.

## Discussion

`appStoreVersionPhasedReleases` handles your process of releasing app updates to customers in stages. Use this resource to set up your process for an app update. This resource is not available for the first version of an app, only for subsequent releases.

For more information, see [Release a version update in phases](https://developer.apple.com/help/app-store-connect/update-your-app/release-a-version-update-in-phases).

## Topics

### Managing Phased Releases

[`Create an app store version phased release`](/documentation/AppStoreConnectAPI/POST-v1-appStoreVersionPhasedReleases)

Enable phased release for an App Store version.

[`Modify an app store version phased release`](/documentation/AppStoreConnectAPI/PATCH-v1-appStoreVersionPhasedReleases-_id_)

Pause or resume a phased release, or immediately release an app.

### Canceling Phased Releases

[`Delete an app store version phased release`](/documentation/AppStoreConnectAPI/DELETE-v1-appStoreVersionPhasedReleases-_id_)

Cancel a planned phased release that has not been started.

### Objects and Data Types

[`AppStoreVersionPhasedRelease`](/documentation/AppStoreConnectAPI/AppStoreVersionPhasedRelease)

The data structure that represent an App Store Version Phased Releases resource.

[`AppStoreVersionPhasedReleaseCreateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionPhasedReleaseCreateRequest)

The request body you use to create an App Store Version Phased Release.

[`AppStoreVersionPhasedReleaseResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionPhasedReleaseResponse)

The response body for endpoints that create, read, or modify the phased release schedule for an App Store version.

[`AppStoreVersionPhasedReleaseWithoutIncludesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionPhasedReleaseWithoutIncludesResponse)

A response containing a single phased release configuration, without related resources.

[`AppStoreVersionPhasedReleaseUpdateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionPhasedReleaseUpdateRequest)

The request body you use to update an App Store Version Phased Release.

[`PhasedReleaseState`](/documentation/AppStoreConnectAPI/PhasedReleaseState)

String that represents the progress of a phased release for an app version.


---

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)