# 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 Availabilities API
  version: 1.0.0
extends: openapi/ios-appavailabilities-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['/v2/appAvailabilities'].post
  update:
    x-apievangelist-phrasing:
      intent: Set where an app is available
      effect: write
      questions:
      - How do I choose which countries my app is sold in?
      - Can I make my app automatically available in new territories Apple adds?
      instructions:
      - text: Create an app availability with {data}.
        slots:
          data: requestBody.data
      - text: Set my app's territory availability and new-territory setting using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appAvailabilities/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's availability settings
      effect: read
      questions:
      - Is my app set to become available in new territories automatically?
      - What does an app availability record show?
      instructions:
      - text: Show app availability {id}.
        slots:
          id: path.id
      - text: Fetch the availability settings for record {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appAvailabilities/{id}/relationships/territoryAvailabilities'].get
  update:
    x-apievangelist-phrasing:
      intent: List territory availability IDs for an app
      effect: read
      questions:
      - Which territory availability IDs belong to an app availability?
      - Can I page through just the per-country availability references?
      instructions:
      - text: List only the territory availability IDs for availability {id}.
        slots:
          id: path.id
      - text: Return up to {limit} territory availability linkages for {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/appAvailabilities/{id}/territoryAvailabilities'].get
  update:
    x-apievangelist-phrasing:
      intent: List per-territory availability for an app
      effect: read
      questions:
      - In which countries is my app available, and are any pre-order only?
      - What release dates and content statuses apply to my app in each territory?
      instructions:
      - text: Show the full per-territory availability for app availability {id}.
        slots:
          id: path.id
      - text: List each country's availability status for {id}, {limit} at a time.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'