<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/build-beta-details",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Build Beta Details"
}
-->

# Build Beta Details

TestFlight-specific information about beta builds.

## Discussion

Every build has a `buildBetaDetails` resource that represents TestFlight-specific information about the build.

## Topics

### Getting Build Beta Details Information

[`GET /v1/buildBetaDetails`](/documentation/AppStoreConnectAPI/GET-v1-buildBetaDetails)

Find and list build beta details for all builds.

[`GET /v1/buildBetaDetails/{id}`](/documentation/AppStoreConnectAPI/GET-v1-buildBetaDetails-_id_)

Get a specific build beta details resource.

[`GET /v1/buildBetaDetails/{id}/build`](/documentation/AppStoreConnectAPI/GET-v1-buildBetaDetails-_id_-build)

Get the build information for a specific build beta details resource.

[`GET /v1/buildBetaDetails/{id}/relationships/build`](/documentation/AppStoreConnectAPI/GET-v1-buildBetaDetails-_id_-relationships-build)

### Modifying Build Beta Details

[`PATCH /v1/buildBetaDetails/{id}`](/documentation/AppStoreConnectAPI/PATCH-v1-buildBetaDetails-_id_)

Update beta test details for a specific build.

### Objects and Data Types

[`BuildBetaDetail`](/documentation/AppStoreConnectAPI/BuildBetaDetail)

The TestFlight distribution settings for a build, including whether it is available for external testing.

[`BuildBetaDetailUpdateRequest`](/documentation/AppStoreConnectAPI/BuildBetaDetailUpdateRequest)

The request body you use to update a Build Data Detail.

[`BuildBetaDetailResponse`](/documentation/AppStoreConnectAPI/BuildBetaDetailResponse)

The response body for endpoints that read or modify beta testing details for a build.

[`BuildBetaDetailsResponse`](/documentation/AppStoreConnectAPI/BuildBetaDetailsResponse)

The response body for endpoints that list beta testing details across builds.

[`ExternalBetaState`](/documentation/AppStoreConnectAPI/ExternalBetaState)

String that represents a build’s availability for external testing.

[`InternalBetaState`](/documentation/AppStoreConnectAPI/InternalBetaState)

String that represents a build’s availability for internal testing.

[`BuildBuildBetaDetailLinkageResponse`](/documentation/AppStoreConnectAPI/BuildBuildBetaDetailLinkageResponse)

[`BuildBundleAppClipDomainCacheStatusLinkageResponse`](/documentation/AppStoreConnectAPI/BuildBundleAppClipDomainCacheStatusLinkageResponse)

[`BuildBundleAppClipDomainDebugStatusLinkageResponse`](/documentation/AppStoreConnectAPI/BuildBundleAppClipDomainDebugStatusLinkageResponse)

[`BuildBundleBetaAppClipInvocationsLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildBundleBetaAppClipInvocationsLinkagesResponse)

[`BuildBundleBuildBundleFileSizesLinkagesResponse`](/documentation/AppStoreConnectAPI/BuildBundleBuildBundleFileSizesLinkagesResponse)


---

Copyright &copy; 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)