# 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 Pre Release Versions API
  version: 1.0.0
extends: openapi/ios-prereleaseversions-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/preReleaseVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List TestFlight pre-release versions
      effect: read
      questions:
      - How do I list the TestFlight pre-release versions for my app?
      - Can I filter pre-release versions by platform or version number?
      - Which pre-release versions have builds that are still processing?
      instructions:
      - text: List pre-release versions for app {app}.
        slots:
          app: query.filter[app]
      - text: Show pre-release version {version} on {platform}.
        slots:
          version: query.filter[version]
          platform: query.filter[platform]
      - text: List pre-release versions whose builds have processing state {state}.
        slots:
          state: query.filter[builds.processingState]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/preReleaseVersions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a TestFlight pre-release version
      effect: read
      questions:
      - Can I look up one pre-release version by ID?
      - What are the details of a specific TestFlight pre-release version?
      instructions:
      - text: Get pre-release version {id}.
        slots:
          id: path.id
      - text: Show TestFlight pre-release version {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/preReleaseVersions/{id}/relationships/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app ID of a pre-release version
      effect: read
      questions:
      - Which app ID does a pre-release version belong to?
      - Can I get only the app reference of a pre-release version?
      instructions:
      - text: Give me only the app ID for pre-release version {id}.
        slots:
          id: path.id
      - text: Return the app linkage of TestFlight pre-release version {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/preReleaseVersions/{id}/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app of a pre-release version
      effect: read
      questions:
      - Which app is this pre-release version for?
      - Where do I see the full app record behind a TestFlight version?
      instructions:
      - text: Show the app for pre-release version {id}.
        slots:
          id: path.id
      - text: Fetch the full app details behind TestFlight pre-release version {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/preReleaseVersions/{id}/relationships/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List build IDs of a pre-release version
      effect: read
      questions:
      - Which build IDs are under a pre-release version?
      - Can I list only the build references for a TestFlight version?
      instructions:
      - text: List only the build IDs of pre-release version {id}.
        slots:
          id: path.id
      - text: Return up to {limit} build linkages for TestFlight pre-release version {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/preReleaseVersions/{id}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List builds of a pre-release version
      effect: read
      questions:
      - What builds have been uploaded for this pre-release version?
      - How do I see each build of a TestFlight version with its details?
      instructions:
      - text: Show the builds of pre-release version {id}.
        slots:
          id: path.id
      - text: List up to {limit} builds with details for TestFlight pre-release version {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'