# 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 Store Review Details API
  version: 1.0.0
extends: openapi/ios-appstorereviewdetails-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/appStoreReviewDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: Add App Review contact and demo details
      effect: write
      questions:
      - How do I give App Review a demo account and contact person for a version?
      - Can I add notes for the App Store reviewer through the API?
      instructions:
      - text: Create App Review details with {review_details}.
        slots:
          review_details: requestBody.data
      - text: Add a demo login and contact phone for App Review on my new version.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreReviewDetails/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get App Review details for a version
      effect: read
      questions:
      - What contact info and demo account did I give App Review?
      - Which reviewer notes are currently attached to my submission?
      instructions:
      - text: Show App Review details {review}.
        slots:
          review: path.id
      - text: Fetch the demo account and reviewer notes in review details {review}.
        slots:
          review: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreReviewDetails/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update App Review details
      effect: write
      questions:
      - How do I change the demo account password I gave App Review?
      - Can I update the reviewer notes before resubmitting?
      instructions:
      - text: Update App Review details {review} with new reviewer notes.
        slots:
          review: path.id
      - text: Change the contact email on review details {review}.
        slots:
          review: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreReviewDetails/{id}/relationships/appStoreReviewAttachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List attachment IDs on App Review details
      effect: read
      questions:
      - Which attachment IDs are attached to my App Review details?
      - Can I get only the references to files I gave the reviewer?
      instructions:
      - text: List only the attachment IDs on review details {review}.
        slots:
          review: path.id
      - text: Get up to {limit} attachment references for review details {review}.
        slots:
          review: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appStoreReviewDetails/{id}/appStoreReviewAttachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List files attached for App Review
      effect: read
      questions:
      - What files have I attached to help App Review test my app?
      - Did my App Review attachments finish uploading?
      instructions:
      - text: Show the attachments on review details {review}, with file details.
        slots:
          review: path.id
      - text: List the first {limit} files attached to review details {review}.
        slots:
          review: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'