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

# Beta Build Localizations

Beta test information about builds, specific to a locale.

## Discussion

A `betaBuildLocalizations` resource represents the localized content that appears in the “What’s New” text in TestFlight. You should change this text for every build.

## Topics

### Getting Build Information

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

Find and list beta build localizations currently associated with apps.

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

Get a specific beta build localization resource.

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

Get the build information for a specific beta build localization.

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

### Creating, Modifying, and Deleting Beta Build Localizations

[`POST /v1/betaBuildLocalizations`](/documentation/AppStoreConnectAPI/POST-v1-betaBuildLocalizations)

Create localized What’s New text for a build.

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

Update the localized What’s New text for a specific beta build and locale.

[`DELETE /v1/betaBuildLocalizations/{id}`](/documentation/AppStoreConnectAPI/DELETE-v1-betaBuildLocalizations-_id_)

Delete a specific beta build localization associated with a build.

### Objects

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

The localized ‘What’s New’ text shown to TestFlight testers in a specific language for a build.

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

The response body for endpoints that create, read, or modify localized TestFlight build metadata.

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

A response containing a list of TestFlight build localizations, without related resources.

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

The request body you use to create a Beta Build Localization.

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

The request body you use to update a Beta Build Localization.

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

The response body for endpoints that list localized TestFlight build metadata entries.

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


---

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)