# 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 Treatments…
  version: 1.0.0
extends: openapi/ios-appstoreversionexperimenttreatments-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: 6
- target: $.paths['/v1/appStoreVersionExperimentTreatments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a product page test treatment
      effect: write
      questions:
      - How do I add a variant to an App Store product page optimization test?
      - Can I create a new treatment with its own app icon?
      instructions:
      - text: Create an experiment treatment with {details}.
        slots:
          details: requestBody.data
      - text: 'Add a product page test variant: {details}.'
        slots:
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product page test treatment
      effect: read
      questions:
      - What does one treatment in my product page test contain?
      - Can I look up a single experiment variant by ID?
      instructions:
      - text: Show experiment treatment {id}.
        slots:
          id: path.id
      - text: Get the details of test variant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product page test treatment
      effect: destructive
      questions:
      - How do I remove a variant from a product page optimization test?
      - Can I delete a treatment before the experiment starts?
      instructions:
      - text: Delete experiment treatment {id}.
        slots:
          id: path.id
      - text: Remove test variant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatments/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a product page test treatment
      effect: write
      questions:
      - Can I rename a treatment or change its icon?
      - How do I edit an experiment variant's settings?
      instructions:
      - text: Update experiment treatment {id} with {details}.
        slots:
          id: path.id
          details: requestBody.data
      - text: Edit test variant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatments/{id}/relationships/appStoreVersionExperimentTreatmentLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localization IDs of a test treatment
      effect: read
      questions:
      - Can I get just the localization IDs of an experiment treatment?
      - Which localization identifiers are attached to a test variant?
      instructions:
      - text: List only the localization IDs of treatment {id}.
        slots:
          id: path.id
      - text: Return up to {limit} localization linkages for treatment {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperimentTreatments/{id}/appStoreVersionExperimentTreatmentLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localizations of a test treatment
      effect: read
      questions:
      - Which languages does a product page test variant have assets for?
      - Can I filter a treatment's localizations by locale?
      instructions:
      - text: Show the localizations of treatment {id}.
        slots:
          id: path.id
      - text: List localizations of treatment {id} in locale {locale}.
        slots:
          id: path.id
          locale: query.filter[locale]
      method: generated
      generated: '2026-10-01'