# 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 Custom Product Page Versions API
  version: 1.0.0
extends: openapi/ios-appcustomproductpageversions-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: 5
- target: $.paths['/v1/appCustomProductPageVersions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom product page version
      effect: write
      questions:
      - How do I start a new version of a custom product page?
      - Can I add a version with a deep link to an existing custom product page?
      instructions:
      - text: Create a custom product page version {version}.
        slots:
          version: requestBody.data
      - text: Start a new version of a custom product page with {version}.
        slots:
          version: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageVersions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom product page version
      effect: read
      questions:
      - What state and deep link does a custom product page version have?
      - Can I look up a custom product page version by ID?
      instructions:
      - text: Get custom product page version {version}.
        slots:
          version: path.id
      - text: Show the state of custom product page version {version}.
        slots:
          version: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageVersions/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a custom product page version
      effect: write
      questions:
      - Can I change the deep link on a custom product page version?
      - What fields of a custom product page version can I edit?
      instructions:
      - text: Update custom product page version {version} with {changes}.
        slots:
          version: path.id
          changes: requestBody.data
      - text: Change the deep link of custom product page version {version} to {changes}.
        slots:
          version: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageVersions/{id}/relationships/appCustomProductPageLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localization IDs of a product page version
      effect: read
      questions:
      - Can I get only the IDs of a custom product page version's localizations?
      - Which localization identifiers belong to a product page version?
      instructions:
      - text: Get the localization IDs for custom product page version {version}.
        slots:
          version: path.id
      - text: Return just the localization linkages of product page version {version}.
        slots:
          version: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageVersions/{id}/appCustomProductPageLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product page version's localizations
      effect: read
      questions:
      - What promotional text is set in each language on my custom product page?
      - Can I get the localization for one locale on a custom product page version?
      instructions:
      - text: List the localizations of custom product page version {version}.
        slots:
          version: path.id
      - text: Show the {locale} localization of product page version {version}.
        slots:
          version: path.id
          locale: query.filter[locale]
      method: generated
      generated: '2026-10-01'