# 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 Experiments API
  version: 1.0.0
extends: openapi/ios-appstoreversionexperiments-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: 12
- target: $.paths['/v2/appStoreVersionExperiments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a product page optimization test
      effect: write
      questions:
      - How do I start a new A/B test of my App Store product page?
      - What do I send to set up a version experiment with the current v2 endpoint?
      instructions:
      - text: Create an App Store version experiment with {data}.
        slots:
          data: requestBody.data
      - text: 'Set up a new product page test using the v2 endpoint: {data}.'
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appStoreVersionExperiments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product page optimization test
      effect: read
      questions:
      - Can I look up a product page experiment by ID?
      - Where do I check the state of an App Store version experiment?
      instructions:
      - text: Get App Store version experiment {id}.
        slots:
          id: path.id
      - text: Show the details of product page test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appStoreVersionExperiments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product page optimization test
      effect: destructive
      questions:
      - Can I delete a product page experiment I no longer need?
      - Is there a way to remove an App Store version experiment?
      instructions:
      - text: Delete App Store version experiment {id}.
        slots:
          id: path.id
      - text: Remove product page test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appStoreVersionExperiments/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a product page optimization test
      effect: write
      questions:
      - Can I edit an App Store version experiment after creating it?
      - How do I change the settings of a running product page test?
      instructions:
      - text: Update App Store version experiment {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Apply {data} to product page test {id}.
        slots:
          data: requestBody.data
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperiments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a version experiment (legacy v1)
      effect: write
      questions:
      - Can I still create a version experiment through the legacy v1 endpoint?
      - What's the older v1 way to set up a product page test tied to an app version?
      instructions:
      - text: Create a version experiment with the legacy v1 endpoint using {data}.
        slots:
          data: requestBody.data
      - text: 'Use the older v1 API to set up a product page test: {data}.'
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperiments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a version experiment (legacy v1)
      effect: read
      questions:
      - Is fetching a version experiment still possible through the legacy v1 endpoint?
      - Can the older v1 API show me one product page test?
      instructions:
      - text: Fetch version experiment {id} via the legacy v1 endpoint.
        slots:
          id: path.id
      - text: Use the older v1 API to show product page test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperiments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a version experiment (legacy v1)
      effect: destructive
      questions:
      - Can I delete a version experiment through the legacy v1 endpoint?
      - Does the older v1 API let me remove a product page test?
      instructions:
      - text: Delete version experiment {id} via the legacy v1 endpoint.
        slots:
          id: path.id
      - text: Use the older v1 API to remove product page test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperiments/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a version experiment (legacy v1)
      effect: write
      questions:
      - Is editing a product page test still possible on the older v1 API?
      - Can I change a version experiment with the legacy v1 PATCH endpoint?
      instructions:
      - text: Update version experiment {id} via the legacy v1 endpoint with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Use the older v1 API to apply {data} to product page test {id}.
        slots:
          data: requestBody.data
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appStoreVersionExperiments/{id}/relationships/appStoreVersionExperimentTreatments'].get
  update:
    x-apievangelist-phrasing:
      intent: List treatment IDs of a product page test
      effect: read
      questions:
      - Which treatment IDs belong to my product page experiment?
      - Can I list only the treatment references of a version experiment?
      instructions:
      - text: List only the treatment IDs for App Store version experiment {id}.
        slots:
          id: path.id
      - text: Return up to {limit} treatment linkages for product page test {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appStoreVersionExperiments/{id}/appStoreVersionExperimentTreatments'].get
  update:
    x-apievangelist-phrasing:
      intent: List treatments of a product page test
      effect: read
      questions:
      - What treatments are part of my product page experiment?
      - Where do I see each variant being tested in an App Store version experiment?
      instructions:
      - text: Show the treatments for App Store version experiment {id}.
        slots:
          id: path.id
      - text: List up to {limit} variants with details for product page test {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperiments/{id}/relationships/appStoreVersionExperimentTreatments'].get
  update:
    x-apievangelist-phrasing:
      intent: List treatment IDs of an experiment (legacy v1)
      effect: read
      questions:
      - Can the legacy v1 endpoint give me just the treatment IDs of an experiment?
      - Which treatment references does the older v1 API return for a version experiment?
      instructions:
      - text: List only treatment IDs for version experiment {id} via the legacy v1 endpoint.
        slots:
          id: path.id
      - text: Use the older v1 API to return {limit} treatment linkages for test {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreVersionExperiments/{id}/appStoreVersionExperimentTreatments'].get
  update:
    x-apievangelist-phrasing:
      intent: List treatments of an experiment (legacy v1)
      effect: read
      questions:
      - How do I see an experiment's treatments through the legacy v1 endpoint?
      - Can the older v1 API list the variants of a product page test with details?
      instructions:
      - text: Show treatments for version experiment {id} via the legacy v1 endpoint.
        slots:
          id: path.id
      - text: Use the older v1 API to list variants with details for test {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'