# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Shopify Applications API
  version: 1.0.0
extends: openapi/shopify-applications-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 104
- target: $.paths['/admin/api/2020-01/reports/{report_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my app's reports (API 2020-01)
      effect: read
      questions:
      - How do I pull up a single report my app created on the 2020-01 Admin API?
      - Can a 2020-01 report lookup return only a few chosen fields?
      instructions:
      - text: Fetch report {report_id} through Admin API version 2020-01.
        slots:
          report_id: path.report_id
      - text: Show just the {fields} of app report {report_id}, January 2020 release.
        slots:
          fields: query.fields
          report_id: path.report_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/reports/{report_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my app's reports (API 2020-04)
      effect: read
      questions:
      - Which call returns a report my app made when I'm pinned to API version 2020-04?
      - Is there a fields filter when reading an app report in the April 2020 release?
      instructions:
      - text: Open my app's report {report_id} on the 2020-04 API.
        slots:
          report_id: path.report_id
      - text: Read report {report_id} from the April 2020 endpoint, limited to {fields}.
        slots:
          report_id: path.report_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/reports/{report_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my app's reports (API 2020-07)
      effect: read
      questions:
      - Where do I read back a report my app built, using the July 2020 Admin API?
      - Does the 2020-07 single-report endpoint let me restrict the response fields?
      instructions:
      - text: Load app-created report {report_id} with the 2020-07 version.
        slots:
          report_id: path.report_id
      - text: Using July 2020 API, give me report {report_id} with only {fields}.
        slots:
          report_id: path.report_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/reports/{report_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my app's reports (API 2020-10)
      effect: read
      questions:
      - What's the current 2020-10 way to retrieve a report my app created?
      - Can I ask for specific fields when getting a report on the October 2020 API?
      instructions:
      - text: Get report {report_id} that my app created, API 2020-10.
        slots:
          report_id: path.report_id
      - text: Return fields {fields} for report {report_id} on the October 2020 version.
        slots:
          fields: query.fields
          report_id: path.report_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/reports/{report_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my app's reports (API 2021-01)
      effect: read
      questions:
      - How can I look at one app report via the 2021-01 Admin API release?
      - Will the January 2021 report endpoint return a subset of fields if I list them?
      instructions:
      - text: Pull app report {report_id} from API version 2021-01.
        slots:
          report_id: path.report_id
      - text: On the 2021 January release, retrieve report {report_id} showing {fields} only.
        slots:
          report_id: path.report_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/reports/{report_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my app's reports (unstable API)
      effect: read
      questions:
      - Can I retrieve a single app report through the unstable Admin API version?
      - What does the unstable-channel report lookup return when I pass a fields list?
      instructions:
      - text: Retrieve report {report_id} from the unstable API channel.
        slots:
          report_id: path.report_id
      - text: Via unstable, fetch {fields} of my app's report {report_id}.
        slots:
          fields: query.fields
          report_id: path.report_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List one-time app charges (API 2020-01)
      effect: read
      questions:
      - How do I see every one-time charge my app has billed a shop, on API 2020-01?
      - Can the 2020-01 one-time charge list start after a given charge ID?
      instructions:
      - text: List all one-time application charges using the 2020-01 version.
      - text: Show one-time app charges newer than {since_id}, January 2020 API.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Bill a shop a one-time app charge (API 2020-01)
      effect: write
      questions:
      - How do I charge a merchant a single one-off fee for my app on the 2020-01 API?
      - Which 2020-01 endpoint creates a one-time application charge?
      instructions:
      - text: Create a one-time application charge with Admin API 2020-01.
      - text: Raise a single non-recurring app fee for this shop via the January 2020 release.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/application_charges/{application_charge_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a one-time app charge (API 2020-01)
      effect: read
      questions:
      - How can I check the status of one specific one-time app charge on 2020-01?
      - Does the January 2020 charge lookup accept a fields list?
      instructions:
      - text: Look up one-time charge {application_charge_id} on API 2020-01.
        slots:
          application_charge_id: path.application_charge_id
      - text: Get the {fields} of application charge {application_charge_id}, January 2020 release.
        slots:
          fields: query.fields
          application_charge_id: path.application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List one-time app charges (API 2020-04)
      effect: read
      questions:
      - Where can I list the one-off fees my app charged, using API version 2020-04?
      - Is paging by since_id supported on the April 2020 one-time charge list?
      instructions:
      - text: Show my app's one-time charges from the 2020-04 API.
      - text: Page April 2020 one-off app charges after ID {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Bill a shop a one-time app charge (API 2020-04)
      effect: write
      questions:
      - Can I bill a store a one-time purchase for my app on the April 2020 API?
      - What call starts a single application charge under version 2020-04?
      instructions:
      - text: Start a one-off application charge on the 2020-04 release.
      - text: Charge the merchant once for my app using April 2020 Admin API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/application_charges/{application_charge_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a one-time app charge (API 2020-04)
      effect: read
      questions:
      - Which 2020-04 call shows me one particular one-time app charge?
      - Can I narrow an April 2020 single-charge response to certain fields?
      instructions:
      - text: Retrieve one-off charge {application_charge_id} via version 2020-04.
        slots:
          application_charge_id: path.application_charge_id
      - text: Using April 2020, show {fields} for one-time charge {application_charge_id}.
        slots:
          fields: query.fields
          application_charge_id: path.application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List one-time app charges (API 2020-07)
      effect: read
      questions:
      - What's the July 2020 endpoint for listing all one-time charges from my app?
      - Can I skip earlier one-time charges with since_id on 2020-07?
      instructions:
      - text: Get every one-time app charge on API 2020-07.
      - text: List July 2020 application charges created after {since_id}, only {fields}.
        slots:
          since_id: query.since_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Bill a shop a one-time app charge (API 2020-07)
      effect: write
      questions:
      - How would I create a one-time app purchase for a store on the 2020-07 release?
      - Is a one-off application charge created with a POST on the July 2020 API?
      instructions:
      - text: Create a one-time charge for my app with the July 2020 version.
      - text: Bill this store a single app payment through 2020-07.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/application_charges/{application_charge_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a one-time app charge (API 2020-07)
      effect: read
      questions:
      - Where do I read a single one-time app charge by ID on the July 2020 API?
      - Can the 2020-07 charge detail call return only the fields I name?
      instructions:
      - text: Fetch application charge {application_charge_id} from 2020-07.
        slots:
          application_charge_id: path.application_charge_id
      - text: Show fields {fields} of one-off charge {application_charge_id}, July 2020 release.
        slots:
          fields: query.fields
          application_charge_id: path.application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List one-time app charges (API 2020-10)
      effect: read
      questions:
      - How can I list the one-time charges my app has made on the current 2020-10 API?
      - Does the October 2020 one-time charge list support since_id paging?
      instructions:
      - text: List one-time application charges, version 2020-10.
      - text: Show October 2020 one-off charges after charge {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Bill a shop a one-time app charge (API 2020-10)
      effect: write
      questions:
      - Can I sell a merchant a one-time app upgrade using the 2020-10 Admin API?
      - Which October 2020 endpoint makes a one-time application charge?
      instructions:
      - text: Make a one-time app charge for the shop on API 2020-10.
      - text: Create a single non-recurring app charge on the October 2020 version.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/application_charges/{application_charge_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a one-time app charge (API 2020-10)
      effect: read
      questions:
      - What's the 2020-10 call to see whether a one-time app charge was accepted?
      - Can I get selected fields of a one-time charge on the October 2020 API?
      instructions:
      - text: Get one-time charge {application_charge_id} with API version 2020-10.
        slots:
          application_charge_id: path.application_charge_id
      - text: Return {fields} for charge {application_charge_id} on the October 2020 release.
        slots:
          fields: query.fields
          application_charge_id: path.application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List one-time app charges (API 2021-01)
      effect: read
      questions:
      - Which call lists my app's one-off charges on the January 2021 API?
      - Is since_id available to page one-time charges in version 2021-01?
      instructions:
      - text: Pull all one-time app charges using 2021-01.
      - text: List 2021-01 one-off application charges beyond ID {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Bill a shop a one-time app charge (API 2021-01)
      effect: write
      questions:
      - How do I create a one-off purchase charge for my app on 2021-01?
      - Does the January 2021 release still let me POST a one-time application charge?
      instructions:
      - text: Issue a one-time app charge via the 2021-01 Admin API.
      - text: Charge this shop a one-off app fee on the January 2021 release.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/application_charges/{application_charge_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a one-time app charge (API 2021-01)
      effect: read
      questions:
      - How can I inspect one specific one-off app charge on the 2021-01 version?
      - Can January 2021 charge lookups be trimmed to particular fields?
      instructions:
      - text: Inspect one-time charge {application_charge_id} on API 2021-01.
        slots:
          application_charge_id: path.application_charge_id
      - text: From the January 2021 release, get {fields} of charge {application_charge_id}.
        slots:
          fields: query.fields
          application_charge_id: path.application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List one-time app charges (unstable API)
      effect: read
      questions:
      - Can I list one-time app charges on the unstable Admin API channel?
      - Does the unstable one-time charge list take a since_id cursor?
      instructions:
      - text: List one-off app charges from the unstable version.
      - text: Via unstable, show one-time charges after {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Bill a shop a one-time app charge (unstable API)
      effect: write
      questions:
      - Is creating a one-time app charge possible on the unstable API version?
      - What unstable-channel endpoint bills a shop once for my app?
      instructions:
      - text: Create a one-time application charge on unstable.
      - text: Bill the store a single app fee through the unstable channel.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/application_charges/{application_charge_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a one-time app charge (unstable API)
      effect: read
      questions:
      - How do I get one one-off app charge by ID on the unstable channel?
      - Can an unstable single-charge lookup return a limited field set?
      instructions:
      - text: Get application charge {application_charge_id} on the unstable API.
        slots:
          application_charge_id: path.application_charge_id
      - text: 'Unstable channel: show {fields} for one-off charge {application_charge_id}.'
        slots:
          fields: query.fields
          application_charge_id: path.application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/application_credits.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue an app credit to a shop (API 2020-01)
      effect: write
      questions:
      - How do I give a merchant a credit toward future app charges on API 2020-01?
      - Which 2020-01 call creates an application credit?
      instructions:
      - text: Issue an application credit to this shop using 2020-01.
      - text: Credit the merchant's app billing via the January 2020 release.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/application_credits/{application_credit_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app credit (API 2020-01)
      effect: read
      questions:
      - Where can I look up one application credit I issued, on version 2020-01?
      - Can a January 2020 credit lookup return just some fields?
      instructions:
      - text: Show application credit {application_credit_id} on API 2020-01.
        slots:
          application_credit_id: path.application_credit_id
      - text: Get {fields} of credit {application_credit_id} from the January 2020 version.
        slots:
          fields: query.fields
          application_credit_id: path.application_credit_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/application_credits.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue an app credit to a shop (API 2020-04)
      effect: write
      questions:
      - Can I credit a store for my app on the April 2020 Admin API?
      - What's the 2020-04 endpoint to create an application credit?
      instructions:
      - text: Create an app credit for the merchant with version 2020-04.
      - text: Give this shop an application credit through April 2020.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/application_credits/{application_credit_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app credit (API 2020-04)
      effect: read
      questions:
      - How can I retrieve a single application credit on the 2020-04 release?
      - Is there a fields option on the April 2020 credit detail call?
      instructions:
      - text: Retrieve app credit {application_credit_id} via 2020-04.
        slots:
          application_credit_id: path.application_credit_id
      - text: 'April 2020: return {fields} for credit {application_credit_id}.'
        slots:
          fields: query.fields
          application_credit_id: path.application_credit_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/application_credits.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue an app credit to a shop (API 2020-07)
      effect: write
      questions:
      - What call issues a merchant credit for my app under API 2020-07?
      - Can I create application credits on the July 2020 version?
      instructions:
      - text: Issue a July 2020 application credit to the shop.
      - text: Add an app billing credit for this store on 2020-07.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/application_credits/{application_credit_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app credit (API 2020-07)
      effect: read
      questions:
      - Which July 2020 endpoint returns one application credit by ID?
      - Can I limit the fields of a 2020-07 application credit response?
      instructions:
      - text: Fetch credit {application_credit_id} from API 2020-07.
        slots:
          application_credit_id: path.application_credit_id
      - text: Show only {fields} of app credit {application_credit_id}, July 2020 release.
        slots:
          fields: query.fields
          application_credit_id: path.application_credit_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/application_credits.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue an app credit to a shop (API 2020-10)
      effect: write
      questions:
      - How do I credit a merchant against future app charges on the 2020-10 API?
      - Is the October 2020 application credit endpoint a POST with no path ID?
      instructions:
      - text: Create an application credit on API version 2020-10.
      - text: Credit this store toward my app's charges using October 2020.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/application_credits/{application_credit_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app credit (API 2020-10)
      effect: read
      questions:
      - What's the current 2020-10 way to read back an application credit?
      - Can the October 2020 credit lookup return selected fields only?
      instructions:
      - text: Get application credit {application_credit_id} on 2020-10.
        slots:
          application_credit_id: path.application_credit_id
      - text: On October 2020, show fields {fields} for app credit {application_credit_id}.
        slots:
          fields: query.fields
          application_credit_id: path.application_credit_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/application_credits.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue an app credit to a shop (API 2021-01)
      effect: write
      questions:
      - Can I still issue an app credit to a merchant on the 2021-01 release?
      - Which January 2021 call creates a credit for my app's billing?
      instructions:
      - text: Issue an app credit with the 2021-01 Admin API.
      - text: Give the merchant a billing credit for my app, January 2021 version.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/application_credits/{application_credit_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app credit (API 2021-01)
      effect: read
      questions:
      - How do I view one application credit on API version 2021-01?
      - Does the January 2021 credit detail endpoint honor a fields list?
      instructions:
      - text: View app credit {application_credit_id} from 2021-01.
        slots:
          application_credit_id: path.application_credit_id
      - text: Read {fields} of application credit {application_credit_id} on the January 2021 release.
        slots:
          fields: query.fields
          application_credit_id: path.application_credit_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/application_credits.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Issue an app credit to a shop (unstable API)
      effect: write
      questions:
      - Can the unstable API version create application credits?
      - What unstable endpoint credits a merchant for my app?
      instructions:
      - text: Create an app credit on the unstable channel.
      - text: Issue this shop an application credit via unstable.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/application_credits/{application_credit_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app credit (unstable API)
      effect: read
      questions:
      - How can I fetch one application credit through the unstable API?
      - Will the unstable credit lookup return only the fields I ask for?
      instructions:
      - text: Get app credit {application_credit_id} on unstable.
        slots:
          application_credit_id: path.application_credit_id
      - text: 'Unstable channel: fetch {fields} of credit {application_credit_id}.'
        slots:
          fields: query.fields
          application_credit_id: path.application_credit_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/recurring_application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app subscriptions (API 2020-01)
      effect: read
      questions:
      - How do I list the recurring subscription charges for my app on API 2020-01?
      - Can I page 2020-01 recurring app charges with since_id?
      instructions:
      - text: List recurring application charges on version 2020-01.
      - text: Show January 2020 app subscriptions after charge {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/recurring_application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an app subscription charge (API 2020-01)
      effect: write
      questions:
      - How do I set up a monthly subscription charge for my app on 2020-01?
      - Which January 2020 call creates a recurring application charge?
      instructions:
      - text: Create a recurring app charge using the 2020-01 API.
      - text: Start a subscription billing plan for this shop, January 2020 release.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/recurring_application_charges/{recurring_application_charge_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an app subscription (API 2020-01)
      effect: destructive
      questions:
      - How do I cancel a merchant's recurring app charge on API 2020-01?
      - Is cancelling a subscription charge a DELETE on the January 2020 version?
      instructions:
      - text: Cancel recurring charge {recurring_application_charge_id} via 2020-01.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      - text: End app subscription {recurring_application_charge_id} on the January 2020 release.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/recurring_application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app subscriptions (API 2020-04)
      effect: read
      questions:
      - Where do I see all recurring app charges with the April 2020 Admin API?
      - Can a 2020-04 subscription charge list return only certain fields?
      instructions:
      - text: Show my app's recurring charges from API 2020-04.
      - text: List April 2020 recurring charges with fields {fields} only.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/recurring_application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an app subscription charge (API 2020-04)
      effect: write
      questions:
      - Can I create a recurring subscription for my app on the 2020-04 version?
      - What April 2020 endpoint bills a merchant on a recurring basis?
      instructions:
      - text: Set up a recurring application charge through 2020-04.
      - text: Begin recurring app billing for the store with the April 2020 API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/recurring_application_charges/{recurring_application_charge_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an app subscription (API 2020-04)
      effect: destructive
      questions:
      - Which 2020-04 call cancels a recurring charge for my app?
      - Can I stop a merchant's app subscription on the April 2020 release?
      instructions:
      - text: Cancel app subscription {recurring_application_charge_id} using 2020-04.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      - text: Stop recurring charge {recurring_application_charge_id} on the April 2020 API.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/recurring_application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app subscriptions (API 2020-07)
      effect: read
      questions:
      - What's the July 2020 call to list my app's recurring subscription charges?
      - Does since_id work on the 2020-07 recurring charge list?
      instructions:
      - text: Get all recurring app charges via 2020-07.
      - text: List July 2020 subscription charges after {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/recurring_application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an app subscription charge (API 2020-07)
      effect: write
      questions:
      - How would I start recurring billing for my app on the 2020-07 release?
      - Is a recurring application charge created by POST on the July 2020 API?
      instructions:
      - text: Create a subscription charge for my app on 2020-07.
      - text: Put this merchant on recurring app billing, July 2020 version.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/recurring_application_charges/{recurring_application_charge_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an app subscription (API 2020-07)
      effect: destructive
      questions:
      - Where do I cancel a recurring app charge on the July 2020 Admin API?
      - What happens to the subscription when I delete a recurring charge on 2020-07?
      instructions:
      - text: Cancel recurring app charge {recurring_application_charge_id}, API 2020-07.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      - text: Terminate subscription {recurring_application_charge_id} with the July 2020 release.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/recurring_application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app subscriptions (API 2020-10)
      effect: read
      questions:
      - How can I see every recurring charge my app has on the current 2020-10 API?
      - Can I filter October 2020 recurring charges to those after a given ID?
      instructions:
      - text: List recurring application charges, version 2020-10.
      - text: Show October 2020 app subscriptions newer than {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/recurring_application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an app subscription charge (API 2020-10)
      effect: write
      questions:
      - How do I charge a merchant a recurring fee for my app on 2020-10?
      - Which October 2020 endpoint creates a recurring application charge?
      instructions:
      - text: Create a recurring app charge on API 2020-10.
      - text: Start subscription billing for this shop on the October 2020 release.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/recurring_application_charges/{recurring_application_charge_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an app subscription (API 2020-10)
      effect: destructive
      questions:
      - How do I cancel a recurring app charge with the 2020-10 Admin API?
      - Can I end a shop's app subscription on the October 2020 version?
      instructions:
      - text: Cancel recurring charge {recurring_application_charge_id} on 2020-10.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      - text: End the app subscription {recurring_application_charge_id} using October 2020.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/recurring_application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app subscriptions (API 2021-01)
      effect: read
      questions:
      - Which call lists recurring app charges on the 2021-01 release?
      - Is there a fields option on the January 2021 subscription charge list?
      instructions:
      - text: Pull my app's recurring charges from 2021-01.
      - text: List January 2021 recurring charges after {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/recurring_application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an app subscription charge (API 2021-01)
      effect: write
      questions:
      - Can I create a recurring charge for my app on API version 2021-01?
      - What January 2021 call puts a store on a recurring app plan?
      instructions:
      - text: Create a recurring application charge via 2021-01.
      - text: Set up a recurring app plan for the shop, January 2021 release.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/recurring_application_charges/{recurring_application_charge_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an app subscription (API 2021-01)
      effect: destructive
      questions:
      - How can I cancel an app's recurring charge on the 2021-01 version?
      - Does the January 2021 API let me cancel a merchant's subscription by charge ID?
      instructions:
      - text: Cancel app subscription {recurring_application_charge_id} on 2021-01.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      - text: Stop recurring billing {recurring_application_charge_id} via the January 2021 API.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/recurring_application_charges.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app subscriptions (unstable API)
      effect: read
      questions:
      - Can I list recurring app charges on the unstable Admin API?
      - Does the unstable recurring charge list support since_id?
      instructions:
      - text: List recurring app charges on unstable.
      - text: Via unstable, show subscription charges after {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/recurring_application_charges.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an app subscription charge (unstable API)
      effect: write
      questions:
      - Is creating a recurring app charge supported on the unstable version?
      - What unstable endpoint starts recurring billing for my app?
      instructions:
      - text: Create a recurring application charge on unstable.
      - text: Start a recurring app plan for this store through the unstable channel.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/recurring_application_charges/{recurring_application_charge_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel an app subscription (unstable API)
      effect: destructive
      questions:
      - How do I cancel a recurring app charge through the unstable API?
      - Can the unstable channel end a merchant's app subscription?
      instructions:
      - text: Cancel recurring charge {recurring_application_charge_id} on unstable.
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      - text: 'Unstable channel: end subscription {recurring_application_charge_id}.'
        slots:
          recurring_application_charge_id: path.recurring_application_charge_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/deprecated_api_calls.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List my app's deprecated API calls (API 2021-01)
      effect: read
      questions:
      - Which deprecated Admin API calls has my app been making, according to 2021-01?
      - Can I audit my app for calls to retired endpoints on the January 2021 release?
      instructions:
      - text: List the deprecated API calls my app made, using 2021-01.
      - text: Show my app's usage of deprecated endpoints from the January 2021 API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/deprecated_api_calls.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List my app's deprecated API calls (unstable API)
      effect: read
      questions:
      - Does the unstable API report which deprecated calls my app still makes?
      - Where do I find my app's deprecated call history on the unstable channel?
      instructions:
      - text: List deprecated calls made by my app via unstable.
      - text: 'Unstable channel: report the retired endpoints my app is still hitting.'
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/collection_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List collections published to my app (API 2020-01)
      effect: read
      questions:
      - How do I see which collections a merchant published to my sales channel app on 2020-01?
      - Can I cap how many collection listings come back on the 2020-01 API?
      instructions:
      - text: List collection listings published to my app, version 2020-01.
      - text: Show the first {limit} collections published to my app, January 2020 release.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/collection_listings/{collection_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a collection listing (API 2020-01)
      effect: read
      questions:
      - Where do I read one collection that's published to my app on API 2020-01?
      - Which January 2020 call returns a single collection listing by ID?
      instructions:
      - text: Get collection listing {collection_listing_id} on 2020-01.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Show published collection {collection_listing_id} from the January 2020 API.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/collection_listings/{collection_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a collection to my app (API 2020-01)
      effect: write
      questions:
      - How do I publish a collection to my sales channel app on the 2020-01 API?
      - Is publishing a collection listing a PUT by collection ID in January 2020?
      instructions:
      - text: Publish collection {collection_listing_id} to my app via 2020-01.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Create a collection listing for {collection_listing_id}, January 2020 release.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/collection_listings/{collection_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a collection from my app (API 2020-01)
      effect: destructive
      questions:
      - How do I take a collection off my sales channel app on API 2020-01?
      - Does deleting a collection listing on 2020-01 unpublish it from my app?
      instructions:
      - text: Unpublish collection {collection_listing_id} from my app using 2020-01.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Delete collection listing {collection_listing_id} on the January 2020 version.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/collection_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List collections published to my app (API 2020-04)
      effect: read
      questions:
      - Which collections are published to my channel app, per the April 2020 API?
      - Is there a limit parameter on 2020-04 collection listings?
      instructions:
      - text: Show collections published to my app with 2020-04.
      - text: List up to {limit} collection listings from the April 2020 version.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/collection_listings/{collection_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a collection listing (API 2020-04)
      effect: read
      questions:
      - How can I fetch one collection listing published to my app on 2020-04?
      - What April 2020 endpoint shows a specific published collection?
      instructions:
      - text: Retrieve collection listing {collection_listing_id} via 2020-04.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Open published collection {collection_listing_id} on the April 2020 release.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/collection_listings/{collection_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a collection to my app (API 2020-04)
      effect: write
      questions:
      - Can I publish a store collection to my channel app on the April 2020 API?
      - Which 2020-04 call creates a collection listing for my app?
      instructions:
      - text: Publish collection {collection_listing_id} to my channel, API 2020-04.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Make collection {collection_listing_id} available in my app, April 2020 version.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/collection_listings/{collection_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a collection from my app (API 2020-04)
      effect: destructive
      questions:
      - How can I unpublish a collection from my app with the 2020-04 release?
      - Which April 2020 call deletes a collection listing?
      instructions:
      - text: Remove collection {collection_listing_id} from my app on 2020-04.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Unpublish collection listing {collection_listing_id} via the April 2020 API.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/collection_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List collections published to my app (API 2020-07)
      effect: read
      questions:
      - What's the July 2020 call to list collection listings for my app?
      - Can I limit the number of 2020-07 collection listings returned?
      instructions:
      - text: Get collection listings for my app from 2020-07.
      - text: Return {limit} published collections via the July 2020 API.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/collection_listings/{collection_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a collection listing (API 2020-07)
      effect: read
      questions:
      - Where do I get a single published collection for my app on 2020-07?
      - Does the July 2020 API return a collection listing by its ID?
      instructions:
      - text: Fetch collection listing {collection_listing_id} on API 2020-07.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Look up published collection {collection_listing_id}, July 2020 release.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/collection_listings/{collection_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a collection to my app (API 2020-07)
      effect: write
      questions:
      - How would I publish a collection to my app using the July 2020 version?
      - Is a collection listing created with PUT on 2020-07?
      instructions:
      - text: Publish collection {collection_listing_id} to my app on 2020-07.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: List collection {collection_listing_id} in my sales channel, July 2020 API.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/collection_listings/{collection_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a collection from my app (API 2020-07)
      effect: destructive
      questions:
      - Can I unpublish a collection from my channel app on API 2020-07?
      - What July 2020 call removes a collection listing?
      instructions:
      - text: Unpublish collection {collection_listing_id} via version 2020-07.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Delete the listing for collection {collection_listing_id}, July 2020 release.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/collection_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List collections published to my app (API 2020-10)
      effect: read
      questions:
      - How do I list the collections published to my sales channel on the 2020-10 API?
      - Can I set a page size for October 2020 collection listings?
      instructions:
      - text: List collection listings on API version 2020-10.
      - text: Show {limit} collections published to my app, October 2020 release.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/collection_listings/{collection_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a collection listing (API 2020-10)
      effect: read
      questions:
      - What's the 2020-10 call to read one collection listing for my app?
      - Can I retrieve a specific published collection on the October 2020 version?
      instructions:
      - text: Get collection listing {collection_listing_id}, API 2020-10.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Show the published collection {collection_listing_id} via October 2020.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/collection_listings/{collection_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a collection to my app (API 2020-10)
      effect: write
      questions:
      - How do I publish a collection to my channel app on the current 2020-10 API?
      - Which October 2020 endpoint creates a collection listing?
      instructions:
      - text: Publish collection {collection_listing_id} to my app on 2020-10.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Create a listing for collection {collection_listing_id} with the October 2020 API.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/collection_listings/{collection_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a collection from my app (API 2020-10)
      effect: destructive
      questions:
      - How can I unpublish a collection from my sales channel with API 2020-10?
      - Does deleting an October 2020 collection listing remove it from my app?
      instructions:
      - text: Unpublish collection {collection_listing_id} on 2020-10.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Delete collection listing {collection_listing_id} via the October 2020 release.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/collection_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List collections published to my app (API 2021-01)
      effect: read
      questions:
      - Which call lists collections published to my app on the 2021-01 release?
      - Is limit supported on January 2021 collection listings?
      instructions:
      - text: Pull collection listings for my app via 2021-01.
      - text: List the first {limit} collections published to my channel, January 2021 API.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/collection_listings/{collection_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a collection listing (API 2021-01)
      effect: read
      questions:
      - How do I view one collection listing for my app on 2021-01?
      - Can I look up a published collection by ID with the January 2021 API?
      instructions:
      - text: View collection listing {collection_listing_id} on 2021-01.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Read published collection {collection_listing_id} from the January 2021 release.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/collection_listings/{collection_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a collection to my app (API 2021-01)
      effect: write
      questions:
      - Can I publish a collection to my sales channel on API version 2021-01?
      - What January 2021 call creates a collection listing?
      instructions:
      - text: Publish collection {collection_listing_id} to my channel via 2021-01.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Add collection {collection_listing_id} to my app, January 2021 version.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/collection_listings/{collection_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a collection from my app (API 2021-01)
      effect: destructive
      questions:
      - How do I remove a collection from my app on the 2021-01 release?
      - Which January 2021 endpoint unpublishes a collection listing?
      instructions:
      - text: Unpublish collection {collection_listing_id} using 2021-01.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Take collection {collection_listing_id} off my channel with the January 2021 API.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/collection_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List collections published to my app (unstable)
      effect: read
      questions:
      - Can I list collection listings for my app on the unstable API?
      - Does the unstable collection listing endpoint accept a limit?
      instructions:
      - text: List collections published to my app on unstable.
      - text: Via unstable, return {limit} collection listings.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/collection_listings/{collection_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a collection listing (unstable API)
      effect: read
      questions:
      - How do I get one collection listing through the unstable version?
      - What unstable call returns a published collection by ID?
      instructions:
      - text: Get collection listing {collection_listing_id} on unstable.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: 'Unstable channel: show published collection {collection_listing_id}.'
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/collection_listings/{collection_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a collection to my app (unstable API)
      effect: write
      questions:
      - Can the unstable API publish a collection to my sales channel app?
      - What unstable endpoint creates a collection listing?
      instructions:
      - text: Publish collection {collection_listing_id} to my app via unstable.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: 'Unstable channel: create a listing for collection {collection_listing_id}.'
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/collection_listings/{collection_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a collection from my app (unstable)
      effect: destructive
      questions:
      - How can I unpublish a collection from my app on the unstable channel?
      - Does the unstable API delete collection listings?
      instructions:
      - text: Unpublish collection {collection_listing_id} on unstable.
        slots:
          collection_listing_id: path.collection_listing_id
      - text: Via unstable, remove the listing for collection {collection_listing_id}.
        slots:
          collection_listing_id: path.collection_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/product_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List products published to my app (API 2020-01)
      effect: read
      questions:
      - How do I list the products a merchant published to my sales channel on API 2020-01?
      - Can I filter 2020-01 product listings by collection or recent updates?
      instructions:
      - text: List product listings in collection {collection_id}, version 2020-01.
        slots:
          collection_id: query.collection_id
      - text: Show products published to my app updated since {updated_at_min}, January 2020 API.
        slots:
          updated_at_min: query.updated_at_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/product_listings/product_ids.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List IDs of products published to my app (2020-01)
      effect: read
      questions:
      - Is there a lightweight 2020-01 call that returns only the product IDs published to my app?
      - How many product IDs can one January 2020 product_ids call return?
      instructions:
      - text: Get the IDs of all products published to my app via 2020-01.
      - text: Return {limit} published product IDs from the January 2020 release.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/product_listings/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count products published to my app (API 2020-01)
      effect: read
      questions:
      - How many products are published to my sales channel app, per API 2020-01?
      - What January 2020 endpoint counts my app's product listings?
      instructions:
      - text: Count product listings for my app on 2020-01.
      - text: Tell me the number of products published to my channel, January 2020 version.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/product_listings/{product_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product listing (API 2020-01)
      effect: read
      questions:
      - Where do I read one product published to my app on the 2020-01 API?
      - Which January 2020 call returns a single product listing?
      instructions:
      - text: Get product listing {product_listing_id} on API 2020-01.
        slots:
          product_listing_id: path.product_listing_id
      - text: Show published product {product_listing_id} from the January 2020 release.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/product_listings/{product_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a product to my app (API 2020-01)
      effect: write
      questions:
      - How do I publish a product to my sales channel app on 2020-01?
      - Is creating a product listing a PUT by product ID on the January 2020 API?
      instructions:
      - text: Publish product {product_listing_id} to my app via 2020-01.
        slots:
          product_listing_id: path.product_listing_id
      - text: Create a product listing for {product_listing_id}, January 2020 version.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/product_listings/{product_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a product from my app (API 2020-01)
      effect: destructive
      questions:
      - How can I unpublish a product from my channel app on API 2020-01?
      - Which January 2020 call deletes a product listing?
      instructions:
      - text: Unpublish product {product_listing_id} from my app on 2020-01.
        slots:
          product_listing_id: path.product_listing_id
      - text: Delete product listing {product_listing_id} using the January 2020 API.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/product_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List products published to my app (API 2020-04)
      effect: read
      questions:
      - Which products are published to my app, using the April 2020 API?
      - Can I look up April 2020 product listings by handle or specific product IDs?
      instructions:
      - text: List product listings with handle {handle} on version 2020-04.
        slots:
          handle: query.handle
      - text: Show published products {product_ids} from the April 2020 release.
        slots:
          product_ids: query.product_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/product_listings/product_ids.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List IDs of products published to my app (2020-04)
      effect: read
      questions:
      - Can I fetch just the product IDs published to my channel on API 2020-04?
      - Does the April 2020 product_ids endpoint take a limit?
      instructions:
      - text: List published product IDs for my app via 2020-04.
      - text: Give me {limit} product IDs published to my channel, April 2020.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/product_listings/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count products published to my app (API 2020-04)
      effect: read
      questions:
      - What's the April 2020 call to count products published to my app?
      - Can I get a product listing total without paging on 2020-04?
      instructions:
      - text: Count products published to my app using 2020-04.
      - text: Return the product listing total for my channel, April 2020 API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/product_listings/{product_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product listing (API 2020-04)
      effect: read
      questions:
      - How can I fetch one product listing for my app on the 2020-04 version?
      - What April 2020 endpoint shows a specific published product?
      instructions:
      - text: Retrieve product listing {product_listing_id} via 2020-04.
        slots:
          product_listing_id: path.product_listing_id
      - text: Open published product {product_listing_id} on the April 2020 release.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/product_listings/{product_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a product to my app (API 2020-04)
      effect: write
      questions:
      - When a merchant picks a product for my channel, how do I list it through the April 2020 API?
      - Which 2020-04 call creates a product listing for my app?
      instructions:
      - text: Publish product {product_listing_id} to my channel, API 2020-04.
        slots:
          product_listing_id: path.product_listing_id
      - text: Make product {product_listing_id} available in my app, April 2020 version.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/product_listings/{product_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a product from my app (API 2020-04)
      effect: destructive
      questions:
      - How do I remove a product from my sales channel app on 2020-04?
      - Does deleting an April 2020 product listing unpublish the product?
      instructions:
      - text: Remove product {product_listing_id} from my app on 2020-04.
        slots:
          product_listing_id: path.product_listing_id
      - text: Unpublish product listing {product_listing_id} via the April 2020 API.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/product_listings.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List products published to my app (API 2020-07)
      effect: read
      questions:
      - What's the July 2020 call to list products published to my sales channel?
      - Can I cap and filter July 2020 product listings by update date?
      instructions:
      - text: List {limit} product listings for my app via 2020-07.
        slots:
          limit: query.limit
      - text: Show July 2020 published products changed after {updated_at_min} in collection {collection_id}.
        slots:
          updated_at_min: query.updated_at_min
          collection_id: query.collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/product_listings/product_ids.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List IDs of products published to my app (2020-07)
      effect: read
      questions:
      - Is there a July 2020 endpoint returning only the IDs of products published to my app?
      - How do I page product IDs for my channel on 2020-07?
      instructions:
      - text: Get published product IDs for my app from 2020-07.
      - text: Return up to {limit} channel product IDs, July 2020 release.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/product_listings/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count products published to my app (API 2020-07)
      effect: read
      questions:
      - How many products has the merchant published to my app, per the 2020-07 API?
      - Which July 2020 call gives a product listing count?
      instructions:
      - text: Count my app's product listings on version 2020-07.
      - text: How many products are in my channel? Use the July 2020 count endpoint.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/product_listings/{product_listing_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product listing (API 2020-07)
      effect: read
      questions:
      - What does one product listing look like when I fetch it by product ID on 2020-07?
      - Does the July 2020 API return a product listing by its ID?
      instructions:
      - text: Fetch product listing {product_listing_id} on API 2020-07.
        slots:
          product_listing_id: path.product_listing_id
      - text: Look up published product {product_listing_id}, July 2020 release.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/product_listings/{product_listing_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Publish a product to my app (API 2020-07)
      effect: write
      questions:
      - Which July 2020 call makes a store product show up in my sales channel?
      - Is a product listing created with PUT on 2020-07?
      instructions:
      - text: Publish product {product_listing_id} to my app on 2020-07.
        slots:
          product_listing_id: path.product_listing_id
      - text: List product {product_listing_id} in my sales channel, July 2020 API.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/product_listings/{product_listing_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unpublish a product from my app (API 2020-07)
      effect: destructive
      questions:
      - How do I stop selling a product through my app with the 2020-07 release?
      - What July 2020 call removes a product listing?
      instructions:
      - text: Unpublish product {product_listing_id} via version 2020-07.
        slots:
          product_listing_id: path.product_listing_id
      - text: Delete the listing for product {product_listing_id}, July 2020 release.
        slots:
          product_listing_id: path.product_listing_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/assigned_fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List fulfillment orders assigned to my app (2020-01)
      effect: read
      questions:
      - How does my fulfillment app see the fulfillment orders assigned to it on API 2020-01?
      - Can I filter 2020-01 assigned fulfillment orders by assignment status?
      instructions:
      - text: List fulfillment orders assigned to my app with status {assignment_status}, API 2020-01.
        slots:
          assignment_status: query.assignment_status
      - text: Show fulfillment orders assigned to locations {location_ids}, January 2020 release.
        slots:
          location_ids: query.location_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/assigned_fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List fulfillment orders assigned to my app (2020-04)
      effect: read
      questions:
      - Which fulfillment orders are assigned to my fulfillment service, per the April 2020 API?
      - Can I narrow 2020-04 assigned fulfillment orders to specific locations?
      instructions:
      - text: Get fulfillment orders assigned to my app at locations {location_ids} via 2020-04.
        slots:
          location_ids: query.location_ids
      - text: List April 2020 assigned fulfillment orders in {assignment_status} status.
        slots:
          assignment_status: query.assignment_status
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/assigned_fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List fulfillment orders assigned to my app (2020-07)
      effect: read
      questions:
      - What's the July 2020 call for a fulfillment app to list its assigned fulfillment orders?
      - Can I find 2020-07 fulfillment orders where the merchant requested cancellation?
      instructions:
      - text: Show my app's assigned fulfillment orders on 2020-07.
      - text: List July 2020 assigned fulfillment orders filtered to {assignment_status}.
        slots:
          assignment_status: query.assignment_status
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/assigned_fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List fulfillment orders assigned to my app (2020-10)
      effect: read
      questions:
      - How can my fulfillment service list the orders assigned to it on the 2020-10 API?
      - Is there a way to see only fulfillment requests awaiting my app's response in October 2020?
      instructions:
      - text: List fulfillment orders assigned to my app in status {assignment_status}, version 2020-10.
        slots:
          assignment_status: query.assignment_status
      - text: Get October 2020 assigned fulfillment orders for locations {location_ids}.
        slots:
          location_ids: query.location_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/assigned_fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List fulfillment orders assigned to my app (2021-01)
      effect: read
      questions:
      - Which call returns fulfillment orders assigned to my app on the 2021-01 release?
      - Can January 2021 assigned fulfillment orders be filtered by location?
      instructions:
      - text: Pull fulfillment orders assigned to my app via 2021-01.
      - text: Show January 2021 assigned fulfillment orders at {location_ids} with status {assignment_status}.
        slots:
          location_ids: query.location_ids
          assignment_status: query.assignment_status
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/assigned_fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List fulfillment orders assigned to my app (unstable)
      effect: read
      questions:
      - Can I list my app's assigned fulfillment orders on the unstable API?
      - Does the unstable assigned fulfillment order list filter by assignment status?
      instructions:
      - text: List assigned fulfillment orders for my app on unstable.
      - text: Via unstable, get assigned fulfillment orders with status {assignment_status}.
        slots:
          assignment_status: query.assignment_status
      method: generated
      generated: '2026-09-24'