# 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 Alternative Distribution Package Versions…
  version: 1.0.0
extends: openapi/ios-alternativedistributionpackageversions-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/alternativeDistributionPackageVersions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an alternative distribution package version
      effect: read
      questions:
      - What is the state and download URL of an alternative marketplace package version?
      - Where can I look up one version of my alternative distribution package?
      instructions:
      - text: Show alternative distribution package version {version}.
        slots:
          version: path.id
      - text: Fetch the URL and status of package version {version}.
        slots:
          version: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/alternativeDistributionPackageVersions/{id}/relationships/deltas'].get
  update:
    x-apievangelist-phrasing:
      intent: List delta IDs for a package version
      effect: read
      questions:
      - Which delta package IDs exist for an alternative distribution version?
      - Can I get only the delta references of a package version?
      instructions:
      - text: List only the delta IDs for package version {version}.
        slots:
          version: path.id
      - text: Get up to {limit} delta references for package version {version}.
        slots:
          version: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/alternativeDistributionPackageVersions/{id}/deltas'].get
  update:
    x-apievangelist-phrasing:
      intent: List the delta update packages of a version
      effect: read
      questions:
      - What delta update files are available for an alternative marketplace version?
      - How do I get the download URLs for a package version's deltas?
      instructions:
      - text: Show the delta packages for version {version} with download URLs.
        slots:
          version: path.id
      - text: List the first {limit} delta updates of package version {version}.
        slots:
          version: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/alternativeDistributionPackageVersions/{id}/relationships/variants'].get
  update:
    x-apievangelist-phrasing:
      intent: List variant IDs for a package version
      effect: read
      questions:
      - Which variant IDs belong to an alternative distribution package version?
      - Can I get only references to a package version's variants?
      instructions:
      - text: List only the variant IDs for package version {version}.
        slots:
          version: path.id
      - text: Get up to {limit} variant references for package version {version}.
        slots:
          version: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/alternativeDistributionPackageVersions/{id}/variants'].get
  update:
    x-apievangelist-phrasing:
      intent: List the device variants of a package version
      effect: read
      questions:
      - What device-specific variants were generated for my alternative distribution package?
      - Where do I find the download URL of each variant in a package version?
      instructions:
      - text: Show the variants of package version {version} with download URLs.
        slots:
          version: path.id
      - text: List the first {limit} device variants of package version {version}.
        slots:
          version: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'