Builds

Information about app builds.

Overview

A builds resource represents a single build of an app. You must upload builds using Xcode or Transporter. Once App Store Connect processes the build, it will appear as a build resource.

Once the build is in the system, you can use the API to perform actions like:

  • Submitting builds for review.

  • Individually assigning builds to testers.

  • Adding the build to a beta group for testing.

Topics

Getting Build Information

List Builds

Find and list builds for all apps in App Store Connect.

Read Build Information

Get information about a specific build.

Read the App Information of a Build

Get the app information for a specific build.

Get the App Resource ID for a Build

Get the app resource ID associated with a specific build.

Read the Prerelease Version of a Build

Get the prerelease version for a specific build.

Get All Resource IDs of Prerelease Versions for a Build

Get a list of resource IDs of prerelease versions associated with a build.

Modifying Builds

Modify a Build

Expire a build or change its encryption exemption setting.

Assign the App Encryption Declaration for a Build

Assign an app encryption declaration to a build.

Adding and Removing Build Access

Add Access for Beta Groups to a Build

Add or create a beta group to a build to enable testing.

Remove Access for Beta Groups to a Build

Remove access to a specific build for all beta testers in one or more beta groups.

Assign Individual Testers to a Build

Enable a beta tester who is not a part of a beta group to test a build.

Remove Individual Testers from a Build

Remove access to test a specific build from one or more individually assigned testers.

Listing Individually Assigned Beta Testers

List All Individual Testers for a Build

Get a list of beta testers individually assigned to a build.

Get All Resource IDs of Individual Testers for a Build

Get a list of resource IDs of individual testers associated with a build.

Checking Beta Review Submission Status

Read the Beta App Review Submission of a Build

Get the beta app review submission status for a specific build.

Get the Beta App Review Submission ID of a Build

Get the beta app review submission resource ID associated with a specific build.

Getting Information Associated with Builds

Read the Build Beta Details Information of a Build

Get the beta test details for a specific build.

Get the Build Beta Details Resource ID for a Build

Get the build beta details resource ID associated with a specific build.

Read the App Encryption Declaration of a Build

Read an app encryption declaration associated with a specific build.

Get the App Encryption Declaration ID for a Build

Get the beta app encryption declaration resource ID associated with a build.

List All Beta Build Localizations of a Build

Get a list of localized beta test information for a specific build.

Get All Beta Build Localization IDs of a Build

Get a list of beta build localization resource IDs associated with a build.

Objects

object Build

The data structure that represents the resource.

object BuildResponse

A response containing a single resource.

object BuildsResponse

A response containing a list of resources.

object BuildUpdateRequest

A request containing a single resource.

object BuildAppLinkageResponse

A response containing the ID of the related resource.

object BuildAppEncryptionDeclarationLinkageRequest

A request containing the ID of the related resource.

object BuildPreReleaseVersionLinkageResponse

A response containing the ID of the related resource.

object BuildAppEncryptionDeclarationLinkageResponse

A response containing the ID of the related resource.

object BuildBuildBetaDetailLinkageResponse

A response containing the ID of the related resource.

object BuildBetaBuildLocalizationsLinkagesResponse

A response containing a list of related resource IDs.

object BuildIndividualTestersLinkagesRequest

A request containing the IDs of related resources.

object BuildIndividualTestersLinkagesResponse

A response containing a list of related resource IDs.

object BuildBetaGroupsLinkagesRequest

A request containing the IDs of related resources.

object ImageAsset

An image asset, including its height, width, and template URL.

See Also

Build Resources

Build Beta Details

TestFlight-specific information about beta builds.

Beta Build Localizations

Beta test information about builds, specific to a locale.

Beta App Review Detail

Information about your app required for beta app review.

Beta App Review Submissions

The submissions of builds for beta app review, including the status of submissions.

Build Beta Notifications

Requests to send notifications to all assigned testers that builds are ready for testing.