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