---
title: Builds
framework: appstoreconnectapi
role: collectionGroup
role_heading: API Collection
path: appstoreconnectapi/builds
---

# Builds

Manage builds for testers and submit builds for review.

## Overview

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](appstoreconnectapi/get-v1-builds.md)
- [Read build information](appstoreconnectapi/get-v1-builds-_id_.md)
- [Read the app information of a build](appstoreconnectapi/get-v1-builds-_id_-app.md)
- [Read the app id of a build](appstoreconnectapi/get-v1-builds-_id_-relationships-app.md)
- [Read the app store version information of a build](appstoreconnectapi/get-v1-builds-_id_-appstoreversion.md)
- [Get the App Store version ID for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-appstoreversion.md)
- [Read the prerelease version of a build](appstoreconnectapi/get-v1-builds-_id_-prereleaseversion.md)
- [Get the prerelease version ID for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-prereleaseversion.md)
- [Read Usage Metrics for a Beta Build](appstoreconnectapi/get-v1-builds-_id_-metrics-betabuildusages.md)

### Modifying Builds

- [Modify a build](appstoreconnectapi/patch-v1-builds-_id_.md)
- [Assign the app encryption declaration for a build](appstoreconnectapi/patch-v1-builds-_id_-relationships-appencryptiondeclaration.md)

### Adding and Removing Build Access

- [Add access for beta groups to a build](appstoreconnectapi/post-v1-builds-_id_-relationships-betagroups.md)
- [Remove access for beta groups to a build](appstoreconnectapi/delete-v1-builds-_id_-relationships-betagroups.md)
- [Assign individual testers to a build](appstoreconnectapi/post-v1-builds-_id_-relationships-individualtesters.md)
- [Remove individual testers from a build](appstoreconnectapi/delete-v1-builds-_id_-relationships-individualtesters.md)

### Listing Individually Assigned Beta Testers

- [List all individual testers for a build](appstoreconnectapi/get-v1-builds-_id_-individualtesters.md)
- [Get all resource ids of individual testers for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-individualtesters.md)

### Checking Beta Review Submission Status

- [Read the beta app review submission of a build](appstoreconnectapi/get-v1-builds-_id_-betaappreviewsubmission.md)
- [Get the beta app review submission ID for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-betaappreviewsubmission.md)

### Getting Information Associated with Builds

- [Read the build beta details information of a build](appstoreconnectapi/get-v1-builds-_id_-buildbetadetail.md)
- [Get the build beta detail ID for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-buildbetadetail.md)
- [Read the app encryption declaration of a build](appstoreconnectapi/get-v1-builds-_id_-appencryptiondeclaration.md)
- [Get the app encryption declaration id for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-appencryptiondeclaration.md)
- [List all beta build localizations of a build](appstoreconnectapi/get-v1-builds-_id_-betabuildlocalizations.md)
- [List beta build localization IDs for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-betabuildlocalizations.md)
- [List all diagnostic signatures for a build](appstoreconnectapi/get-v1-builds-_id_-diagnosticsignatures.md)
- [List all icons for a build](appstoreconnectapi/get-v1-builds-_id_-icons.md)
- [List icon IDs for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-icons.md)
- [List diagnostic signature IDs for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-diagnosticsignatures.md)
- [Get the App Store version ID for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-appstoreversion.md)

### Objects and data types

- [Build](appstoreconnectapi/build.md)
- [BuildResponse](appstoreconnectapi/buildresponse.md)
- [BuildWithoutIncludesResponse](appstoreconnectapi/buildwithoutincludesresponse.md)
- [BuildsResponse](appstoreconnectapi/buildsresponse.md)
- [BuildsWithoutIncludesResponse](appstoreconnectapi/buildswithoutincludesresponse.md)
- [BuildUpdateRequest](appstoreconnectapi/buildupdaterequest.md)
- [BuildAppEncryptionDeclarationLinkageRequest](appstoreconnectapi/buildappencryptiondeclarationlinkagerequest.md)
- [BuildAppEncryptionDeclarationLinkageResponse](appstoreconnectapi/buildappencryptiondeclarationlinkageresponse.md)
- [BuildIndividualTestersLinkagesRequest](appstoreconnectapi/buildindividualtesterslinkagesrequest.md)
- [BuildIndividualTestersLinkagesResponse](appstoreconnectapi/buildindividualtesterslinkagesresponse.md)
- [BuildBetaGroupsLinkagesRequest](appstoreconnectapi/buildbetagroupslinkagesrequest.md)
- [ImageAsset](appstoreconnectapi/imageasset.md)
- [BetaBuildUsagesV1MetricResponse](appstoreconnectapi/betabuildusagesv1metricresponse.md)
- [BuildAppLinkageResponse](appstoreconnectapi/buildapplinkageresponse.md)
- [BuildAppStoreVersionLinkageResponse](appstoreconnectapi/buildappstoreversionlinkageresponse.md)
- [BuildBetaAppReviewSubmissionLinkageResponse](appstoreconnectapi/buildbetaappreviewsubmissionlinkageresponse.md)
- [BuildBetaBuildLocalizationsLinkagesResponse](appstoreconnectapi/buildbetabuildlocalizationslinkagesresponse.md)
- [BuildBetaDetailBuildLinkageResponse](appstoreconnectapi/buildbetadetailbuildlinkageresponse.md)
- [BuildDiagnosticSignaturesLinkagesResponse](appstoreconnectapi/builddiagnosticsignatureslinkagesresponse.md)
- [BuildIconsLinkagesResponse](appstoreconnectapi/buildiconslinkagesresponse.md)
- [BuildPerfPowerMetricsLinkagesResponse](appstoreconnectapi/buildperfpowermetricslinkagesresponse.md)
- [BuildPreReleaseVersionLinkageResponse](appstoreconnectapi/buildprereleaseversionlinkageresponse.md)
- [BuildAudienceType](appstoreconnectapi/buildaudiencetype.md)
- [DiagnosticInsightDirection](appstoreconnectapi/diagnosticinsightdirection.md)
- [DiagnosticInsightType](appstoreconnectapi/diagnosticinsighttype.md)

## See Also

### Builds

- [Build Bundles](appstoreconnectapi/build-bundles.md)
- [Build Icons](appstoreconnectapi/build-icons.md)
- [Build uploads](appstoreconnectapi/build-uploads.md)
- [App Encryption Declarations](appstoreconnectapi/app-encryption-declarations.md)