# Builds Manage builds for testers and submit builds for review. ## Discussion A `builds` resource represents a single build of an app. You must upload builds using Xcode, Transporter, or the [Build uploads](/documentation/AppStoreConnectAPI/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`](/documentation/AppStoreConnectAPI/GET-v1-builds) Find and list builds for all apps in App Store Connect. [`Read Build Information`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_) Get information about a specific build. [`Read the App Information of a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-app) Get the app information for a specific build. [`Read the app ID of a build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-app) Get the app ID for a specific build. [`Read the App Store Version Information of a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-appStoreVersion) Get the App Store version of a specific build. [`GET /v1/builds/{id}/relationships/appStoreVersion`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-appStoreVersion) [`Read the Prerelease Version of a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-preReleaseVersion) Get the prerelease version for a specific build. [`GET /v1/builds/{id}/relationships/preReleaseVersion`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-preReleaseVersion) [`Read usage metrics for a beta build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-metrics-betaBuildUsages) Get usage metrics for a specific build. ### Modifying Builds [`Modify a Build`](/documentation/AppStoreConnectAPI/PATCH-v1-builds-_id_) Expire a build or change its encryption exemption setting. [`Assign the App Encryption Declaration for a Build`](/documentation/AppStoreConnectAPI/PATCH-v1-builds-_id_-relationships-appEncryptionDeclaration) Assign an app encryption declaration to a build. ### Adding and Removing Build Access [`Add Access for Beta Groups to a Build`](/documentation/AppStoreConnectAPI/POST-v1-builds-_id_-relationships-betaGroups) Add or create a beta group to a build to enable testing. [`Remove Access for Beta Groups to a Build`](/documentation/AppStoreConnectAPI/DELETE-v1-builds-_id_-relationships-betaGroups) Remove access to a specific build for all beta testers in one or more beta groups. [`Assign Individual Testers to a Build`](/documentation/AppStoreConnectAPI/POST-v1-builds-_id_-relationships-individualTesters) Enable a beta tester who is not a part of a beta group to test a build. [`Remove Individual Testers from a Build`](/documentation/AppStoreConnectAPI/DELETE-v1-builds-_id_-relationships-individualTesters) 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`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-individualTesters) Get a list of beta testers individually assigned to a build. [`Get All Resource IDs of Individual Testers for a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-individualTesters) 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`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-betaAppReviewSubmission) Get the beta app review submission status for a specific build. [`GET /v1/builds/{id}/relationships/betaAppReviewSubmission`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-betaAppReviewSubmission) ### Getting Information Associated with Builds [`Read the Build Beta Details Information of a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-buildBetaDetail) Get the beta test details for a specific build. [`GET /v1/builds/{id}/relationships/buildBetaDetail`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-buildBetaDetail) [`Read the App Encryption Declaration of a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-appEncryptionDeclaration) Read an app encryption declaration associated with a specific build. [`Get the App Encryption Declaration ID for a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-appEncryptionDeclaration) Get the beta app encryption declaration resource ID associated with a build. [`List All Beta Build Localizations of a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-betaBuildLocalizations) Get a list of localized beta test information for a specific build. [`GET /v1/builds/{id}/relationships/betaBuildLocalizations`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-betaBuildLocalizations) [`List All Diagnostic Signatures for a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-diagnosticSignatures) List the aggregate backtrace signatures captured for a specific build. [`List All Icons for a Build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-icons) List all the icons for various platforms delivered with a build. [`GET /v1/builds/{id}/relationships/icons`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-icons) [`GET /v1/builds/{id}/relationships/diagnosticSignatures`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-diagnosticSignatures) [`GET /v1/builds/{id}/relationships/appStoreVersion`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-relationships-appStoreVersion) ### Objects and data types [`Build`](/documentation/AppStoreConnectAPI/Build) The data structure that represents a Builds resource. [`BuildResponse`](/documentation/AppStoreConnectAPI/BuildResponse) A response that contains a single Builds resource. [`BuildWithoutIncludesResponse`](/documentation/AppStoreConnectAPI/BuildWithoutIncludesResponse) [`BuildsResponse`](/documentation/AppStoreConnectAPI/BuildsResponse) A response that contains a list of Builds resources. [`BuildsWithoutIncludesResponse`](/documentation/AppStoreConnectAPI/BuildsWithoutIncludesResponse) [`BuildUpdateRequest`](/documentation/AppStoreConnectAPI/BuildUpdateRequest) The request body you use to update a Build. [`BuildAppEncryptionDeclarationLinkageRequest`](/documentation/AppStoreConnectAPI/BuildAppEncryptionDeclarationLinkageRequest) The request body you use to attach an app encryption declaration to a build. [`BuildAppEncryptionDeclarationLinkageResponse`](/documentation/AppStoreConnectAPI/BuildAppEncryptionDeclarationLinkageResponse) A response body that contains the ID of a single related resource. [`BuildIndividualTestersLinkagesRequest`](/documentation/AppStoreConnectAPI/BuildIndividualTestersLinkagesRequest) A request body you use to add or remove a build from multiple beta groups. [`BuildIndividualTestersLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildIndividualTestersLinkagesResponse) A response body that contains a list of related resource IDs. [`BuildBetaGroupsLinkagesRequest`](/documentation/AppStoreConnectAPI/BuildBetaGroupsLinkagesRequest) A request body you use to add or remove beta groups from a build. [`ImageAsset`](/documentation/AppStoreConnectAPI/ImageAsset) An image asset, including its height, width, and template URL. [`BetaBuildUsagesV1MetricResponse`](/documentation/AppStoreConnectAPI/BetaBuildUsagesV1MetricResponse) A response that contains one or more beta build metric resources. [`BuildAppLinkageResponse`](/documentation/AppStoreConnectAPI/BuildAppLinkageResponse) [`BuildAppStoreVersionLinkageResponse`](/documentation/AppStoreConnectAPI/BuildAppStoreVersionLinkageResponse) [`BuildBetaAppReviewSubmissionLinkageResponse`](/documentation/AppStoreConnectAPI/BuildBetaAppReviewSubmissionLinkageResponse) [`BuildBetaBuildLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildBetaBuildLocalizationsLinkagesResponse) [`BuildBetaDetailBuildLinkageResponse`](/documentation/AppStoreConnectAPI/BuildBetaDetailBuildLinkageResponse) [`BuildDiagnosticSignaturesLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildDiagnosticSignaturesLinkagesResponse) [`BuildIconsLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildIconsLinkagesResponse) [`BuildPerfPowerMetricsLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildPerfPowerMetricsLinkagesResponse) [`BuildPreReleaseVersionLinkageResponse`](/documentation/AppStoreConnectAPI/BuildPreReleaseVersionLinkageResponse) [`BuildAudienceType`](/documentation/AppStoreConnectAPI/BuildAudienceType) A string that represents the App Store Connect audience for a build. [`DiagnosticInsightDirection`](/documentation/AppStoreConnectAPI/DiagnosticInsightDirection) A string that describes the diagnostic insight direction. [`DiagnosticInsightType`](/documentation/AppStoreConnectAPI/DiagnosticInsightType) A string that desribes the diagnostic insight type. --- Copyright © 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)