# 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 Price Schedules API
  version: 1.0.0
extends: openapi/ios-apppriceschedules-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: 8
- target: $.paths['/v1/appPriceSchedules'].post
  update:
    x-apievangelist-phrasing:
      intent: Set an app's price schedule
      effect: write
      questions:
      - How do I change the price of my paid app starting on a future date?
      - Can I set a base territory and manual prices for my app in one schedule?
      instructions:
      - text: Create an app price schedule with {data}.
        slots:
          data: requestBody.data
      - text: Set my app's pricing, base territory and manual prices using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appPriceSchedules/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's price schedule
      effect: read
      questions:
      - What does my app's current price schedule look like?
      - Can I read a single app price schedule record by its ID?
      instructions:
      - text: Show app price schedule {id}.
        slots:
          id: path.id
      - text: Fetch the pricing schedule details for {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appPriceSchedules/{id}/relationships/automaticPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List automatic app price IDs in a schedule
      effect: read
      questions:
      - Which automatically equalized app price IDs belong to a price schedule?
      - Can I get only the references to auto-generated territory prices for my app?
      instructions:
      - text: List only the automatic price IDs in app price schedule {id}.
        slots:
          id: path.id
      - text: Return up to {limit} automatic price linkages for app schedule {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appPriceSchedules/{id}/automaticPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List automatically equalized app prices
      effect: read
      questions:
      - What prices did Apple automatically set for my app in other countries?
      - Can I see the auto-equalized app price for one territory over a date range?
      instructions:
      - text: Show the automatic territory prices in app price schedule {id}.
        slots:
          id: path.id
      - text: List automatic app prices in schedule {id} for territory {territory} starting {startDate}.
        slots:
          id: path.id
          territory: query.filter[territory]
          startDate: query.filter[startDate]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appPriceSchedules/{id}/relationships/baseTerritory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the base territory ID of an app price schedule
      effect: read
      questions:
      - Which territory ID is the base for my app's price schedule?
      - Can I check only the base territory reference of an app price schedule?
      instructions:
      - text: Return only the base territory ID of app price schedule {id}.
        slots:
          id: path.id
      - text: Check the base territory linkage on app schedule {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appPriceSchedules/{id}/baseTerritory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the base territory of an app price schedule
      effect: read
      questions:
      - Which country and currency is my app's pricing anchored to?
      - What base territory do other app prices get equalized from?
      instructions:
      - text: Show the full base territory and currency for app price schedule {id}.
        slots:
          id: path.id
      - text: Fetch the territory my app prices are based on in schedule {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appPriceSchedules/{id}/relationships/manualPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List manual app price IDs in a schedule
      effect: read
      questions:
      - Which manually set app price IDs are in a price schedule?
      - Can I get only the references to prices I set by hand for my app?
      instructions:
      - text: List only the manual price IDs in app price schedule {id}.
        slots:
          id: path.id
      - text: Return up to {limit} manual price linkages for app schedule {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appPriceSchedules/{id}/manualPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List manually set app prices
      effect: read
      questions:
      - What prices did I set by hand for my app, and when do they take effect?
      - Can I list my app's manual prices for one territory ending before a certain date?
      instructions:
      - text: Show the manual prices in app price schedule {id}.
        slots:
          id: path.id
      - text: List manual app prices in schedule {id} for territory {territory} ending {endDate}.
        slots:
          id: path.id
          territory: query.filter[territory]
          endDate: query.filter[endDate]
      method: generated
      generated: '2026-10-01'