# 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 Beta App Review Details API
  version: 1.0.0
extends: openapi/ios-betaappreviewdetails-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/betaAppReviewDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: List beta app review details for an app
      effect: read
      questions:
      - Where do I find the TestFlight beta review details on file for my app?
      - Which beta app review details exist for a given app?
      instructions:
      - text: List the beta app review details for app {app}.
        slots:
          app: query.filter[app]
      - text: Show the TestFlight review info filed for app {app}, up to {limit} entries.
        slots:
          app: query.filter[app]
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewDetails/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a beta app review detail
      effect: read
      questions:
      - Can I look up a beta app review detail record by ID?
      - What's in a specific TestFlight beta review detail?
      instructions:
      - text: Get beta app review detail {id}.
        slots:
          id: path.id
      - text: Show TestFlight beta review detail {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewDetails/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update beta app review details
      effect: write
      questions:
      - How do I change the review contact information for TestFlight beta review?
      - Can I edit my beta app review details before submitting a build?
      instructions:
      - text: Update beta app review detail {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Apply {data} to TestFlight beta review detail {id}.
        slots:
          data: requestBody.data
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewDetails/{id}/relationships/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app ID of a beta review detail
      effect: read
      questions:
      - Which app ID is a beta app review detail linked to?
      - Can I get only the app reference of a beta review detail?
      instructions:
      - text: Give me only the app ID for beta app review detail {id}.
        slots:
          id: path.id
      - text: Return the app linkage of TestFlight beta review detail {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/betaAppReviewDetails/{id}/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app of a beta review detail
      effect: read
      questions:
      - Which app do these beta review details belong to?
      - Where do I see the full app behind a beta app review detail?
      instructions:
      - text: Show the app for beta app review detail {id}.
        slots:
          id: path.id
      - text: Fetch the full app record behind TestFlight beta review detail {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'