<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-store-version-experiment-treatments",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Store Version Experiment Treatments"
}
-->

# App Store Version Experiment Treatments

Create and update the metadata and the optional icon that represent the treatment you apply to an App Store version experiment.

## Topics

### Endpoints

[`GET /v2/appStoreVersionExperiments/{id}/appStoreVersionExperimentTreatments`](/documentation/AppStoreConnectAPI/GET-v2-appStoreVersionExperiments-_id_-appStoreVersionExperimentTreatments)

Get a list of all treatments for a specific App Store version experiment.

[`GET /v2/appStoreVersionExperiments/{id}/relationships/appStoreVersionExperimentTreatments`](/documentation/AppStoreConnectAPI/GET-v2-appStoreVersionExperiments-_id_-relationships-appStoreVersionExperimentTreatments)

Get a list of experiment treatment IDs for a specific App Store version experiment.

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

Get information about a specific App Store version experiment treatment.

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

Get a list of all localizations for a specific App Store version experiment treatment.

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

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

Update the name and app icon name for a specific App Store version experiment.

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

Add a new treatment to an App Store version experiment.

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

Delete metadata that you configured for an App Store Version experiment.

### Objects

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

One variant in an App Store product page A/B experiment, containing a set of alternative screenshots, previews, and promotional text.

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

The request body you use to create an App Store version experiment treatment.

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

The response body for endpoints that create, read, or modify an App Store version experiment treatment.

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

The request body you use to update an app store version experiment treatment update request.

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

The response body for endpoints that list treatments for an App Store version experiment.

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

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

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

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

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



---

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)