# 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 Clip App Store Review Details API
  version: 1.0.0
extends: openapi/ios-appclipappstorereviewdetails-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: 3
- target: $.paths['/v1/appClipAppStoreReviewDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: Add App Review details for an App Clip
      effect: write
      questions:
      - How do I give App Review the invocation URLs to test my App Clip?
      - Can I add review details to an App Clip default experience?
      instructions:
      - text: Create App Clip review details from {details}.
        slots:
          details: requestBody.data
      - text: 'Give App Review these App Clip invocation URLs: {details}.'
        slots:
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appClipAppStoreReviewDetails/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get App Review details for an App Clip
      effect: read
      questions:
      - What invocation URLs have I already given App Review for my App Clip?
      - Can I look up App Clip review details by ID?
      instructions:
      - text: Show App Clip review details {id}.
        slots:
          id: path.id
      - text: List the invocation URLs in App Clip review record {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appClipAppStoreReviewDetails/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update App Review details for an App Clip
      effect: write
      questions:
      - Can I change the App Clip invocation URLs I submitted for review?
      - Which call edits existing App Clip review details?
      instructions:
      - text: Update App Clip review details {id} with {changes}.
        slots:
          id: path.id
          changes: requestBody.data
      - text: Replace the invocation URLs on App Clip review record {id} with {changes}.
        slots:
          id: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'