Builds

Overview

A builds resource represents a single build of an app. You must upload builds using Xcode, Transporter, or the Build uploads resource. Once App Store Connect processes the build, it appears 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
• Read build information
• Read the app information of a build
• Read the app id of a build
• Read the app store version information of a build
• Get the App Store version ID for a build
• Read the prerelease version of a build
• Get the prerelease version ID for a build
• Read Usage Metrics for a Beta Build

Modifying Builds

• Modify a build
• Assign the app encryption declaration for a build

Adding and Removing Build Access

• Add access for beta groups to a build
• Remove access for beta groups to a build
• Assign individual testers to a build
• Remove individual testers from a build

Listing Individually Assigned Beta Testers

• List all individual testers for a build
• Get all resource ids of individual testers for a build

Checking Beta Review Submission Status

• Read the beta app review submission of a build
• Get the beta app review submission ID for a build

Getting Information Associated with Builds

• Read the build beta details information of a build
• Get the build beta detail ID for a build
• Read the app encryption declaration of a build
• Get the app encryption declaration id for a build
• List all beta build localizations of a build
• List beta build localization IDs for a build
• List all diagnostic signatures for a build
• List all icons for a build
• List icon IDs for a build
• List diagnostic signature IDs for a build
• Get the App Store version ID for a build

Objects and data types

• Build
• BuildResponse
• BuildWithoutIncludesResponse
• BuildsResponse
• BuildsWithoutIncludesResponse
• BuildUpdateRequest
• BuildAppEncryptionDeclarationLinkageRequest
• BuildAppEncryptionDeclarationLinkageResponse
• BuildIndividualTestersLinkagesRequest
• BuildIndividualTestersLinkagesResponse
• BuildBetaGroupsLinkagesRequest
• ImageAsset
• BetaBuildUsagesV1MetricResponse
• BuildAppLinkageResponse
• BuildAppStoreVersionLinkageResponse
• BuildBetaAppReviewSubmissionLinkageResponse
• BuildBetaBuildLocalizationsLinkagesResponse
• BuildBetaDetailBuildLinkageResponse
• BuildDiagnosticSignaturesLinkagesResponse
• BuildIconsLinkagesResponse
• BuildPerfPowerMetricsLinkagesResponse
• BuildPreReleaseVersionLinkageResponse
• BuildAudienceType
• DiagnosticInsightDirection
• DiagnosticInsightType

See Also

Builds

• Build Bundles
• Build Icons
• Build uploads
• App Encryption Declarations