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 /v1/builds/{id}/relationships/appStoreVersion
• Read the Prerelease Version of a Build
• GET /v1/builds/{id}/relationships/preReleaseVersion
• 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 /v1/builds/{id}/relationships/betaAppReviewSubmission

Getting Information Associated with Builds

• Read the Build Beta Details Information of a Build
• GET /v1/builds/{id}/relationships/buildBetaDetail
• 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
• GET /v1/builds/{id}/relationships/betaBuildLocalizations
• List All Diagnostic Signatures for a Build
• List All Icons for a Build
• GET /v1/builds/{id}/relationships/icons
• GET /v1/builds/{id}/relationships/diagnosticSignatures
• GET /v1/builds/{id}/relationships/appStoreVersion

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