# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect App Store Version Experiment Treatment…
  version: 1.0.0
extends: openapi/ios-appstoreversionexperimenttreatmentlocalizations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/v1/appStoreVersionExperimentTreatmentLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Localize a product page test treatment
      effect: write
      questions:
      - How do I add a locale to a treatment in my App Store product page optimization test?
      - Can I give an experiment treatment its own screenshots per language?
      instructions:
      - text: Create a treatment localization from {localization}.
        slots:
          localization: requestBody.data
      - text: Add a German locale to my product page experiment treatment using {localization}.
        slots:
          localization: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatmentLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a treatment localization
      effect: read
      questions:
      - Which locale does a given experiment treatment localization cover?
      - Can I look up one treatment localization by its ID?
      instructions:
      - text: Show treatment localization {id}.
        slots:
          id: path.id
      - text: Fetch experiment treatment locale {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatmentLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a treatment localization
      effect: destructive
      questions:
      - Can I remove a language from a product page optimization treatment?
      - Does deleting a treatment localization also drop its screenshot sets?
      instructions:
      - text: Delete treatment localization {id}.
        slots:
          id: path.id
      - text: Remove experiment treatment locale {id} permanently.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatmentLocalizations/{id}/relationships/appPreviewSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List preview set IDs for a treatment locale
      effect: read
      questions:
      - Which app preview set IDs are attached to my treatment localization?
      - Can I get only identifiers for a treatment locale's video previews?
      instructions:
      - text: List the app preview set IDs linked to treatment localization {id}.
        slots:
          id: path.id
      - text: Return only video preview set references for experiment locale {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatmentLocalizations/{id}/appPreviewSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List preview sets for a treatment locale
      effect: read
      questions:
      - What app preview videos am I testing in this treatment localization?
      - Can I filter a treatment's preview sets by device preview type?
      instructions:
      - text: Show the full app preview sets for treatment localization {id}.
        slots:
          id: path.id
      - text: List preview sets of type {previewType} in experiment locale {id}.
        slots:
          id: path.id
          previewType: query.filter[previewType]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatmentLocalizations/{id}/relationships/appScreenshotSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List screenshot set IDs for a treatment locale
      effect: read
      questions:
      - Which screenshot set IDs belong to my treatment localization?
      - Can I fetch just the identifiers of a treatment locale's screenshot sets?
      instructions:
      - text: List the screenshot set IDs linked to treatment localization {id}.
        slots:
          id: path.id
      - text: Return only screenshot set references for experiment locale {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatmentLocalizations/{id}/appScreenshotSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List screenshot sets for a treatment locale
      effect: read
      questions:
      - What screenshots am I testing in this product page treatment localization?
      - Can I filter a treatment's screenshot sets by display type, like iPhone 6.7-inch?
      instructions:
      - text: Show the full screenshot sets for treatment localization {id}.
        slots:
          id: path.id
      - text: List screenshot sets for display type {displayType} in experiment locale {id}.
        slots:
          id: path.id
          displayType: query.filter[screenshotDisplayType]
      method: generated
      generated: '2026-10-01'