# 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 Subscription App Store Review Screenshots…
  version: 1.0.0
extends: openapi/ios-subscriptionappstorereviewscreenshots-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: 4
- target: $.paths['/v1/subscriptionAppStoreReviewScreenshots'].post
  update:
    x-apievangelist-phrasing:
      intent: Reserve a review screenshot for a subscription
      effect: write
      questions:
      - How do I add the review screenshot App Review needs for an auto-renewable subscription?
      - Can I upload a subscription review screenshot through the API?
      instructions:
      - text: Create a subscription review screenshot with {screenshot}.
        slots:
          screenshot: requestBody.data
      - text: Reserve an upload for the App Review screenshot of my subscription using {screenshot}.
        slots:
          screenshot: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/subscriptionAppStoreReviewScreenshots/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a subscription review screenshot
      effect: read
      questions:
      - What's the upload state of my subscription's review screenshot?
      - Can I fetch the file details of a subscription review screenshot?
      instructions:
      - text: Get subscription review screenshot {screenshot}.
        slots:
          screenshot: path.id
      - text: Check whether subscription screenshot {screenshot} finished uploading.
        slots:
          screenshot: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/subscriptionAppStoreReviewScreenshots/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subscription review screenshot
      effect: destructive
      questions:
      - How do I remove the wrong review screenshot from a subscription?
      - Can I delete a subscription review screenshot and upload another?
      instructions:
      - text: Delete subscription review screenshot {screenshot}.
        slots:
          screenshot: path.id
      - text: Remove the subscription's App Review screenshot {screenshot}.
        slots:
          screenshot: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/subscriptionAppStoreReviewScreenshots/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Commit a subscription review screenshot upload
      effect: write
      questions:
      - After uploading the image parts, what marks a subscription review screenshot as uploaded?
      - Can I update a subscription review screenshot record with its checksum?
      instructions:
      - text: Update subscription review screenshot {screenshot} with {changes}.
        slots:
          screenshot: path.id
          changes: requestBody.data
      - text: Mark subscription screenshot {screenshot} as uploaded using {changes}.
        slots:
          screenshot: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'