# 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 Price Schedules API
  version: 1.0.0
extends: openapi/ios-inapppurchasepriceschedules-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/inAppPurchasePriceSchedules'].post
  update:
    x-apievangelist-phrasing:
      intent: Set an in-app purchase's price schedule
      effect: write
      questions:
      - How do I price a consumable in-app purchase and schedule a future change?
      - Can I choose the base territory for an in-app purchase's pricing?
      instructions:
      - text: Create an in-app purchase price schedule with {data}.
        slots:
          data: requestBody.data
      - text: Set pricing for my in-app purchase using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchasePriceSchedules/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an in-app purchase's price schedule
      effect: read
      questions:
      - What price schedule is applied to one of my in-app purchases?
      - Can I read an in-app purchase price schedule by its ID?
      instructions:
      - text: Show in-app purchase price schedule {id}.
        slots:
          id: path.id
      - text: Fetch the IAP pricing schedule details for {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchasePriceSchedules/{id}/relationships/automaticPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List automatic IAP price IDs in a schedule
      effect: read
      questions:
      - Which auto-equalized price IDs belong to an in-app purchase price schedule?
      - Can I get only references to the automatic prices of an IAP?
      instructions:
      - text: List only the automatic price IDs in IAP price schedule {id}.
        slots:
          id: path.id
      - text: Return up to {limit} automatic price linkages for in-app purchase schedule {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchasePriceSchedules/{id}/automaticPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List automatically equalized in-app purchase prices
      effect: read
      questions:
      - What did my in-app purchase get priced at automatically in each storefront?
      - Can I check the automatic IAP price in a single territory?
      instructions:
      - text: Show the automatic territory prices for IAP price schedule {id}.
        slots:
          id: path.id
      - text: Get the automatic in-app purchase price in territory {territory} for schedule {id}.
        slots:
          id: path.id
          territory: query.filter[territory]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchasePriceSchedules/{id}/relationships/baseTerritory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the base territory ID of an IAP price schedule
      effect: read
      questions:
      - Which territory ID anchors an in-app purchase's price schedule?
      - Can I check only the base territory reference for IAP pricing?
      instructions:
      - text: Return only the base territory ID of IAP price schedule {id}.
        slots:
          id: path.id
      - text: Check the base territory linkage on in-app purchase schedule {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchasePriceSchedules/{id}/baseTerritory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the base territory of an IAP price schedule
      effect: read
      questions:
      - Which country and currency is my in-app purchase priced from?
      - What base storefront do my IAP's other prices derive from?
      instructions:
      - text: Show the full base territory for in-app purchase price schedule {id}.
        slots:
          id: path.id
      - text: Fetch the territory and currency my IAP pricing is based on in schedule {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchasePriceSchedules/{id}/relationships/manualPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List manual IAP price IDs in a schedule
      effect: read
      questions:
      - Which manually set price IDs are in an in-app purchase price schedule?
      - Can I get only references to the hand-set prices of an IAP?
      instructions:
      - text: List only the manual price IDs in IAP price schedule {id}.
        slots:
          id: path.id
      - text: Return up to {limit} manual price linkages for in-app purchase schedule {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inAppPurchasePriceSchedules/{id}/manualPrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List manually set in-app purchase prices
      effect: read
      questions:
      - Which territories have a price I set by hand for this in-app purchase?
      - Can I see the manual IAP price I configured for one storefront?
      instructions:
      - text: Show the manual prices in IAP price schedule {id}.
        slots:
          id: path.id
      - text: Get the manual in-app purchase price for territory {territory} in schedule {id}.
        slots:
          id: path.id
          territory: query.filter[territory]
      method: generated
      generated: '2026-10-01'