# 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 In App Purchase Availabilities API
  version: 1.0.0
extends: openapi/ios-inapppurchaseavailabilities-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/inAppPurchaseAvailabilities'].post
  update:
    x-apievangelist-phrasing:
      intent: Set where an in-app purchase is available
      effect: write
      questions:
      - How do I choose which countries an in-app purchase is sold in?
      - Can I make an in-app purchase automatically available in new territories?
      instructions:
      - text: Set in-app purchase availability using {availability}.
        slots:
          availability: requestBody.data
      - text: Make my in-app purchase available in the territories listed in {availability}.
        slots:
          availability: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchaseAvailabilities/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an in-app purchase's availability
      effect: read
      questions:
      - Is my in-app purchase set to be available in new territories automatically?
      - Can I look up an in-app purchase availability record by ID?
      instructions:
      - text: Show in-app purchase availability {id}.
        slots:
          id: path.id
      - text: Check whether availability {id} auto-includes new territories.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchaseAvailabilities/{id}/relationships/availableTerritories'].get
  update:
    x-apievangelist-phrasing:
      intent: List territory IDs for an IAP availability
      effect: read
      questions:
      - Which territory codes is my in-app purchase available in?
      - Can I get only the territory identifiers for an IAP availability?
      instructions:
      - text: List the territory IDs linked to in-app purchase availability {id}.
        slots:
          id: path.id
      - text: Return only country references for IAP availability {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchaseAvailabilities/{id}/availableTerritories'].get
  update:
    x-apievangelist-phrasing:
      intent: List territories where an IAP is sold
      effect: read
      questions:
      - In which countries, with their currencies, can customers buy my in-app purchase?
      - Can I page through every territory an in-app purchase is offered in?
      instructions:
      - text: Show the full territories for in-app purchase availability {id}.
        slots:
          id: path.id
      - text: List up to {limit} countries and currencies where IAP availability {id} applies.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'