# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Shopify All API
  version: 1.0.0
extends: openapi/shopify-all-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: 107
- target: $.paths['/admin/api/2020-01/application_credits.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app credits issued (API 2020-01)
      effect: read
      questions:
      - Which application credits has my app granted to merchants on API version 2020-01?
      - Can the 2020-01 app credits list be trimmed to certain fields?
      instructions:
      - text: List all application credits using the 2020-01 API.
      - text: Fetch app credits via 2020-01, returning only {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/application_credits.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app credits issued (API 2020-04)
      effect: read
      questions:
      - What credits have I given merchants toward my app fees, per release 2020-04?
      - Does version 2020-04 let me choose which app credit fields come back?
      instructions:
      - text: Pull every application credit through release 2020-04.
      - text: Get 2020-04 application credits showing just {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/application_credits.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app credits issued (API 2020-07)
      effect: read
      questions:
      - How can I review the app credits my app has handed out with version 2020-07?
      - Is it possible to limit app credit fields when calling 2020-07?
      instructions:
      - text: Show the application credits my app issued, API 2020-07.
      - text: On 2020-07, list app credits with only the {fields} fields.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/application_credits.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app credits issued (API 2020-10)
      effect: read
      questions:
      - What application credits has my Shopify app issued to shops?
      - Can I list app credits on the current 2020-10 API with selected fields only?
      instructions:
      - text: List my app's application credits with API version 2020-10.
      - text: Retrieve application credits on 2020-10 including only {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/application_credits.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app credits issued (API 2021-01)
      effect: read
      questions:
      - Which credits toward future app charges exist, according to the 2021-01 release?
      - Can 2021-01 return a slimmed-down set of fields for each application credit?
      instructions:
      - text: Fetch application credits via the 2021-01 release.
      - text: Using API 2021-01, get app credits restricted to {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/application_credits.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List app credits issued (unstable API)
      effect: read
      questions:
      - What app credits does the unstable API version report for my app?
      - Can I request only some application credit fields from the unstable release?
      instructions:
      - text: List application credits from the unstable API.
      - text: Get app credits on the unstable version with fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/customers/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all customers (API 2020-01)
      effect: read
      questions:
      - How many customers does my store have, counted with API 2020-01?
      - Can version 2020-01 give me a total customer count without listing them?
      instructions:
      - text: Count every customer in the store using release 2020-01.
      - text: Give me the total number of customers via the 2020-01 API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/customers/{customer_id}/orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a customer's orders (API 2020-01)
      effect: read
      questions:
      - What orders has one specific customer placed, per API version 2020-01?
      - Can I see a single buyer's order history with the 2020-01 release?
      instructions:
      - text: List orders belonging to customer {customer_id} using 2020-01.
        slots:
          customer_id: path.customer_id
      - text: Show customer {customer_id}'s purchase history via API 2020-01.
        slots:
          customer_id: path.customer_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/customers/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all customers (API 2020-04)
      effect: read
      questions:
      - What's my shop's total customer count on release 2020-04?
      - Is there a quick customer tally endpoint in version 2020-04?
      instructions:
      - text: Get the customer count for my shop with 2020-04.
      - text: Tell me how many customer records exist, API version 2020-04.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/customers/{customer_id}/orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a customer's orders (API 2020-04)
      effect: read
      questions:
      - Which purchases did a particular customer make, checked on release 2020-04?
      - How can I pull every order for one shopper with version 2020-04?
      instructions:
      - text: Get all orders for customer {customer_id} through 2020-04.
        slots:
          customer_id: path.customer_id
      - text: Fetch the orders placed by customer {customer_id} on API 2020-04.
        slots:
          customer_id: path.customer_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/customers/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all customers (API 2020-07)
      effect: read
      questions:
      - How big is my customer base according to the 2020-07 API?
      - Can I fetch just the number of customers under version 2020-07?
      instructions:
      - text: Return the store's customer total through 2020-07.
      - text: Count customers on API release 2020-07.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/customers/{customer_id}/orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a customer's orders (API 2020-07)
      effect: read
      questions:
      - Can the 2020-07 API list everything one customer has ordered?
      - What does a given buyer's order list look like under version 2020-07?
      instructions:
      - text: Retrieve customer {customer_id}'s orders with release 2020-07.
        slots:
          customer_id: path.customer_id
      - text: On 2020-07, list every order tied to customer {customer_id}.
        slots:
          customer_id: path.customer_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/customers/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all customers (API 2020-10)
      effect: read
      questions:
      - How many customers are in my Shopify store in total?
      - Can the 2020-10 API count customers instead of paging through them?
      instructions:
      - text: Count all customers in my store with API 2020-10.
      - text: Get the total customer number from version 2020-10.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/customers/{customer_id}/orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a customer's orders (API 2020-10)
      effect: read
      questions:
      - How do I see all the orders one customer has placed in my Shopify store?
      - Can the current 2020-10 API return a customer's full order history?
      instructions:
      - text: List all orders for customer {customer_id} with API 2020-10.
        slots:
          customer_id: path.customer_id
      - text: Show me what customer {customer_id} has bought, version 2020-10.
        slots:
          customer_id: path.customer_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/customers/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all customers (API 2021-01)
      effect: read
      questions:
      - What total number of customers does release 2021-01 report for my shop?
      - Is a customer headcount available from API version 2021-01?
      instructions:
      - text: Fetch my customer count through the 2021-01 release.
      - text: Using 2021-01, tell me how many customers the shop has.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/customers/{customer_id}/orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a customer's orders (API 2021-01)
      effect: read
      questions:
      - Which orders belong to a certain customer according to release 2021-01?
      - Is a per-customer order list available in API version 2021-01?
      instructions:
      - text: Fetch orders placed by customer {customer_id} via 2021-01.
        slots:
          customer_id: path.customer_id
      - text: Using the 2021-01 release, get customer {customer_id}'s orders.
        slots:
          customer_id: path.customer_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/customers/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all customers (unstable API)
      effect: read
      questions:
      - How many customers does the unstable API say my store has?
      - Can I get a customer total from the unstable version?
      instructions:
      - text: Count customers using the unstable API.
      - text: Return the total customers from the unstable release.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/customers/{customer_id}/orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a customer's orders (unstable API)
      effect: read
      questions:
      - What orders does the unstable API show for one customer?
      - Can I list a single shopper's purchases on the unstable version?
      instructions:
      - text: List customer {customer_id}'s orders from the unstable API.
        slots:
          customer_id: path.customer_id
      - text: Get every order for customer {customer_id} on the unstable release.
        slots:
          customer_id: path.customer_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/customer_saved_searches/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count customer saved searches (API 2020-01)
      effect: read
      questions:
      - How many saved customer searches (segments) exist in my store on API 2020-01?
      - Can the 2020-01 count skip saved searches up to a given ID?
      instructions:
      - text: Count the customer saved searches using release 2020-01.
      - text: Count saved customer searches created after ID {since_id}, API 2020-01.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/customer_saved_searches/{customer_saved_search_id}/customers.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List customers in a saved search (API 2020-01)
      effect: read
      questions:
      - Which customers match one of my saved customer searches on API 2020-01?
      - Can I sort or cap the customers a saved search returns with version 2020-01?
      instructions:
      - text: List the customers returned by saved search {search} using 2020-01.
        slots:
          search: path.customer_saved_search_id
      - text: Show up to {limit} customers from saved search {search}, sorted by {order}, API 2020-01.
        slots:
          search: path.customer_saved_search_id
          limit: query.limit
          order: query.order
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/customer_saved_searches/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count customer saved searches (API 2020-04)
      effect: read
      questions:
      - What's the total number of saved customer filters under version 2020-04?
      - Is there a way to count only newer customer saved searches with 2020-04?
      instructions:
      - text: Get the number of customer saved searches via 2020-04.
      - text: Tally saved searches with IDs past {since_id} on release 2020-04.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/customer_saved_searches/{customer_saved_search_id}/customers.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List customers in a saved search (API 2020-04)
      effect: read
      questions:
      - Who falls into a particular saved customer segment, per release 2020-04?
      - Can a 2020-04 saved search return just some customer fields?
      instructions:
      - text: Get customers matching saved search {search} via 2020-04.
        slots:
          search: path.customer_saved_search_id
      - text: Fetch {fields} for customers in saved search {search}, release 2020-04.
        slots:
          search: path.customer_saved_search_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/customer_saved_searches/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count customer saved searches (API 2020-07)
      effect: read
      questions:
      - How many customer saved searches does API version 2020-07 report?
      - Can I count saved customer searches beyond a certain ID in 2020-07?
      instructions:
      - text: Return a count of saved customer searches with 2020-07.
      - text: On 2020-07, count customer saved searches after {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/customer_saved_searches/{customer_saved_search_id}/customers.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List customers in a saved search (API 2020-07)
      effect: read
      questions:
      - How do I pull the members of a saved customer search with version 2020-07?
      - Can I order the customers from a saved search in 2020-07?
      instructions:
      - text: Retrieve customers in saved search {search} on 2020-07.
        slots:
          search: path.customer_saved_search_id
      - text: On API 2020-07, list saved search {search}'s customers ordered by {order}.
        slots:
          search: path.customer_saved_search_id
          order: query.order
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/customer_saved_searches/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count customer saved searches (API 2020-10)
      effect: read
      questions:
      - How many saved customer searches have been set up in my Shopify admin?
      - Can the 2020-10 API count saved searches created after a known ID?
      instructions:
      - text: Count all customer saved searches with API 2020-10.
      - text: Count customer saved searches newer than ID {since_id}, version 2020-10.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/customer_saved_searches/{customer_saved_search_id}/customers.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List customers in a saved search (API 2020-10)
      effect: read
      questions:
      - How do I get every customer that matches a saved search in my Shopify admin?
      - What's the most customers one saved search call returns on API 2020-10?
      instructions:
      - text: List customers returned by saved search {search} with API 2020-10.
        slots:
          search: path.customer_saved_search_id
      - text: Get the first {limit} customers from saved search {search}, version 2020-10.
        slots:
          search: path.customer_saved_search_id
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/customer_saved_searches/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count customer saved searches (API 2021-01)
      effect: read
      questions:
      - What number of customer saved searches exists according to release 2021-01?
      - Does 2021-01 let me count only saved searches after a starting ID?
      instructions:
      - text: Fetch the saved customer search count through 2021-01.
      - text: Using API 2021-01, count saved searches following ID {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}/customers.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List customers in a saved search (API 2021-01)
      effect: read
      questions:
      - Which shoppers belong to one saved customer search according to 2021-01?
      - Can release 2021-01 limit saved search results to certain customer fields?
      instructions:
      - text: Fetch the customers in saved search {search} through 2021-01.
        slots:
          search: path.customer_saved_search_id
      - text: Using 2021-01, return only {fields} for saved search {search}'s customers.
        slots:
          search: path.customer_saved_search_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/customer_saved_searches/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count customer saved searches (unstable API)
      effect: read
      questions:
      - How many customer saved searches does the unstable API count?
      - Can the unstable release count saved searches after a specific ID?
      instructions:
      - text: Count customer saved searches on the unstable API.
      - text: From the unstable version, count saved searches past ID {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/customer_saved_searches/{customer_saved_search_id}/customers.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List customers in a saved search (unstable API)
      effect: read
      questions:
      - What customers does a saved search return on the unstable API?
      - Can I cap how many customers come back from a saved search on the unstable release?
      instructions:
      - text: List customers from saved search {search} on the unstable API.
        slots:
          search: path.customer_saved_search_id
      - text: Return {limit} customers from saved search {search} using the unstable version.
        slots:
          search: path.customer_saved_search_id
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/blogs/{blog_id}/articles.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a blog's articles (API 2020-01)
      effect: read
      questions:
      - Which posts are in one of my store's blogs, per API version 2020-01?
      - Can I filter a blog's articles by tag using release 2020-01?
      instructions:
      - text: List articles in blog {blog_id} using the 2020-01 API.
        slots:
          blog_id: path.blog_id
      - text: Show articles tagged {tag} in blog {blog_id}, API 2020-01.
        slots:
          blog_id: path.blog_id
          tag: query.tag
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/blogs/{blog_id}/articles/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a blog's articles (API 2020-01)
      effect: read
      questions:
      - How many articles does one blog hold, counted with API 2020-01?
      - Can version 2020-01 count only the published posts in a blog?
      instructions:
      - text: Count the articles in blog {blog_id} using 2020-01.
        slots:
          blog_id: path.blog_id
      - text: Count blog {blog_id} articles whose status is {published_status}, API 2020-01.
        slots:
          blog_id: path.blog_id
          published_status: query.published_status
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/articles/authors.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article authors (API 2020-01)
      effect: read
      questions:
      - Who has written articles on my store blogs, per API version 2020-01?
      - Can I get the names of all article authors with release 2020-01?
      instructions:
      - text: List every article author using the 2020-01 API.
      - text: Show the blog authors across my store via 2020-01.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/articles/tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article tags (API 2020-01)
      effect: read
      questions:
      - Which tags are used on my store's blog articles, per API 2020-01?
      - Can version 2020-01 sort article tags by how popular they are?
      instructions:
      - text: List all article tags using the 2020-01 API.
      - text: Show the top {limit} article tags ordered by popularity, API 2020-01.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/blogs/{blog_id}/articles.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a blog's articles (API 2020-04)
      effect: read
      questions:
      - How do I pull every article from a store blog with version 2020-04?
      - Can I see only unpublished drafts in a blog on 2020-04?
      instructions:
      - text: Get the articles of blog {blog_id} via 2020-04.
        slots:
          blog_id: path.blog_id
      - text: Fetch blog {blog_id} articles with published status {published_status}, release 2020-04.
        slots:
          blog_id: path.blog_id
          published_status: query.published_status
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/blogs/{blog_id}/articles/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a blog's articles (API 2020-04)
      effect: read
      questions:
      - What's the post total for a store blog on release 2020-04?
      - Can I count a blog's articles created in a date window with 2020-04?
      instructions:
      - text: Get the article count for blog {blog_id} via release 2020-04.
        slots:
          blog_id: path.blog_id
      - text: Tally articles in blog {blog_id} created since {created_at_min}, version 2020-04.
        slots:
          blog_id: path.blog_id
          created_at_min: query.created_at_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/articles/authors.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article authors (API 2020-04)
      effect: read
      questions:
      - Which authors appear on my shop's blog posts under version 2020-04?
      - Is there a list of blog writers available in release 2020-04?
      instructions:
      - text: Get all article authors through release 2020-04.
      - text: Fetch the names of blog post authors, API 2020-04.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/articles/tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article tags (API 2020-04)
      effect: read
      questions:
      - What tags have been applied to blog posts, checked on release 2020-04?
      - Can I cap how many article tags come back with 2020-04?
      instructions:
      - text: Get every blog article tag via 2020-04.
      - text: Fetch up to {limit} article tags on release 2020-04.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/blogs/{blog_id}/articles.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a blog's articles (API 2020-07)
      effect: read
      questions:
      - What articles has a given blog published, checked on release 2020-07?
      - Can the 2020-07 API list only one author's articles in a blog?
      instructions:
      - text: Retrieve blog {blog_id}'s articles with version 2020-07.
        slots:
          blog_id: path.blog_id
      - text: On 2020-07, list articles in blog {blog_id} written by {author}.
        slots:
          blog_id: path.blog_id
          author: query.author
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/blogs/{blog_id}/articles/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a blog's articles (API 2020-07)
      effect: read
      questions:
      - How many posts has a given blog got, per the 2020-07 API?
      - Is it possible to count articles updated recently in one blog on 2020-07?
      instructions:
      - text: Return how many articles blog {blog_id} has on 2020-07.
        slots:
          blog_id: path.blog_id
      - text: On API 2020-07, count blog {blog_id} articles updated after {updated_at_min}.
        slots:
          blog_id: path.blog_id
          updated_at_min: query.updated_at_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/articles/authors.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article authors (API 2020-07)
      effect: read
      questions:
      - How do I find out who authored my store's articles on 2020-07?
      - What author names does version 2020-07 return for blog content?
      instructions:
      - text: Retrieve the list of article authors with 2020-07.
      - text: On API 2020-07, list the people who wrote my blog articles.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/articles/tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article tags (API 2020-07)
      effect: read
      questions:
      - How do I see the full set of article tags with version 2020-07?
      - Can the 2020-07 API rank blog tags from most to least used?
      instructions:
      - text: Retrieve the article tags in my store with 2020-07.
      - text: On 2020-07, list {limit} blog tags with the most popular first.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/blogs/{blog_id}/articles.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a blog's articles (API 2020-10)
      effect: read
      questions:
      - How do I list all the articles in one of my Shopify store's blogs?
      - Can I get just the articles published within a date range on API 2020-10?
      - What's the maximum number of blog articles one page returns on 2020-10?
      instructions:
      - text: List every article in blog {blog_id} with API 2020-10.
        slots:
          blog_id: path.blog_id
      - text: Show blog {blog_id} articles published after {published_at_min}, version 2020-10.
        slots:
          blog_id: path.blog_id
          published_at_min: query.published_at_min
      - text: Find the article with handle {handle} in blog {blog_id} on 2020-10.
        slots:
          blog_id: path.blog_id
          handle: query.handle
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/blogs/{blog_id}/articles/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a blog's articles (API 2020-10)
      effect: read
      questions:
      - How many articles are in one of my Shopify blogs?
      - Can the 2020-10 API count only unpublished articles in a blog?
      instructions:
      - text: Count all articles in blog {blog_id} with API 2020-10.
        slots:
          blog_id: path.blog_id
      - text: Count blog {blog_id} articles published before {published_at_max}, version 2020-10.
        slots:
          blog_id: path.blog_id
          published_at_max: query.published_at_max
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/articles/authors.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article authors (API 2020-10)
      effect: read
      questions:
      - Who are all the authors of articles on my Shopify store blogs?
      - Can the 2020-10 API give me every blog article author name?
      instructions:
      - text: List all article authors with API 2020-10.
      - text: Show me everyone who has authored a blog article, version 2020-10.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/articles/tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article tags (API 2020-10)
      effect: read
      questions:
      - What tags are used across all the articles in my Shopify blogs?
      - Which blog article tags are the most popular on API 2020-10?
      instructions:
      - text: List all article tags with API 2020-10.
      - text: Show my {limit} most popular article tags, version 2020-10.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/blogs/{blog_id}/articles.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a blog's articles (API 2021-01)
      effect: read
      questions:
      - Which articles live in a particular blog, according to release 2021-01?
      - Can 2021-01 limit a blog's articles to ones updated after a date?
      instructions:
      - text: Fetch articles from blog {blog_id} through the 2021-01 release.
        slots:
          blog_id: path.blog_id
      - text: Using 2021-01, get blog {blog_id} articles updated since {updated_at_min}.
        slots:
          blog_id: path.blog_id
          updated_at_min: query.updated_at_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/blogs/{blog_id}/articles/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a blog's articles (API 2021-01)
      effect: read
      questions:
      - What number of articles does release 2021-01 report for a blog?
      - Can I count a blog's posts published after some date using 2021-01?
      instructions:
      - text: Fetch the article total for blog {blog_id} through 2021-01.
        slots:
          blog_id: path.blog_id
      - text: Using 2021-01, count articles in blog {blog_id} published since {published_at_min}.
        slots:
          blog_id: path.blog_id
          published_at_min: query.published_at_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/articles/authors.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article authors (API 2021-01)
      effect: read
      questions:
      - Which writers does release 2021-01 list for my store's articles?
      - Can I pull blog author names using version 2021-01?
      instructions:
      - text: Fetch article authors via the 2021-01 release.
      - text: Using 2021-01, get the author list for store blog posts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/articles/tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article tags (API 2021-01)
      effect: read
      questions:
      - Which article tags does release 2021-01 return for my store?
      - Can I limit the number of blog tags returned using 2021-01?
      instructions:
      - text: Fetch blog article tags through the 2021-01 release.
      - text: Using 2021-01, get no more than {limit} article tags.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/blogs/{blog_id}/articles.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a blog's articles (unstable API)
      effect: read
      questions:
      - What articles does the unstable API return for one blog?
      - Can the unstable release list blog articles created before a certain date?
      instructions:
      - text: List blog {blog_id}'s articles from the unstable API.
        slots:
          blog_id: path.blog_id
      - text: Get articles in blog {blog_id} created before {created_at_max}, unstable version.
        slots:
          blog_id: path.blog_id
          created_at_max: query.created_at_max
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/blogs/{blog_id}/articles/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a blog's articles (unstable API)
      effect: read
      questions:
      - How many articles does one blog have according to the unstable API?
      - Can the unstable release count a blog's articles created before a date?
      instructions:
      - text: Count blog {blog_id}'s articles on the unstable API.
        slots:
          blog_id: path.blog_id
      - text: From the unstable version, count blog {blog_id} articles created before {created_at_max}.
        slots:
          blog_id: path.blog_id
          created_at_max: query.created_at_max
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/articles/authors.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article authors (unstable API)
      effect: read
      questions:
      - Who has authored my store's articles, according to the unstable API?
      - Can the unstable release list every blog author?
      instructions:
      - text: List article authors from the unstable API.
      - text: Get the blog author names on the unstable version.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/articles/tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List blog article tags (unstable API)
      effect: read
      questions:
      - What article tags does the unstable API list?
      - Can the unstable release order blog tags by popularity?
      instructions:
      - text: List article tags from the unstable API.
      - text: Get {limit} article tags sorted by popularity on the unstable version.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/blogs.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List store blogs (API 2020-01)
      effect: read
      questions:
      - Which blogs does my online store have, per API version 2020-01?
      - Can I find a blog by its handle using the 2020-01 release?
      instructions:
      - text: List all blogs in my store using API 2020-01.
      - text: Find the blog with handle {handle} via release 2020-01.
        slots:
          handle: query.handle
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/blogs/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count store blogs (API 2020-01)
      effect: read
      questions:
      - How many blogs has my store set up, according to API 2020-01?
      - Is there a blog total endpoint in version 2020-01?
      instructions:
      - text: Count the blogs in my shop with the 2020-01 API.
      - text: Tell me the number of store blogs via release 2020-01.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/script_tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List storefront script tags (API 2020-01)
      effect: read
      questions:
      - Which script tags are injecting JavaScript into my storefront, per API 2020-01?
      - Can I find script tags loading a particular script URL with release 2020-01?
      instructions:
      - text: List all script tags using the 2020-01 API.
      - text: Show script tags whose source is {src}, API 2020-01.
        slots:
          src: query.src
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/script_tags/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count storefront script tags (API 2020-01)
      effect: read
      questions:
      - How many script tags are installed on my store, counted with API 2020-01?
      - Can version 2020-01 count script tags that load one specific URL?
      instructions:
      - text: Count all script tags using release 2020-01.
      - text: Count script tags with source {src}, API 2020-01.
        slots:
          src: query.src
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/script_tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List storefront script tags (API 2020-04)
      effect: read
      questions:
      - What third-party scripts has my app added to the store, checked on 2020-04?
      - Can I list only script tags created after a date under version 2020-04?
      instructions:
      - text: Get every script tag via release 2020-04.
      - text: Fetch script tags created since {created_at_min} on 2020-04.
        slots:
          created_at_min: query.created_at_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/script_tags/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count storefront script tags (API 2020-04)
      effect: read
      questions:
      - What's the total number of script tags on my shop under 2020-04?
      - Is it possible to count script tags by source URL on release 2020-04?
      instructions:
      - text: Get the script tag count via 2020-04.
      - text: Tally script tags loading {src} on version 2020-04.
        slots:
          src: query.src
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/script_tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List storefront script tags (API 2020-07)
      effect: read
      questions:
      - How do I see all the script tags on my online store with version 2020-07?
      - Can the 2020-07 API page through script tags after a known ID?
      instructions:
      - text: Retrieve the store's script tags with 2020-07.
      - text: On 2020-07, list script tags after ID {since_id}.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/script_tags/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count storefront script tags (API 2020-07)
      effect: read
      questions:
      - How many storefront scripts are registered, per the 2020-07 API?
      - Can I count only the script tags for one script URL with 2020-07?
      instructions:
      - text: Return how many script tags exist on 2020-07.
      - text: On API 2020-07, count script tags whose src is {src}.
        slots:
          src: query.src
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/script_tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List storefront script tags (API 2020-10)
      effect: read
      questions:
      - What script tags are loading remote JavaScript on my Shopify storefront?
      - Can I filter script tags by their source URL on API 2020-10?
      - How many script tags can one page of results hold on version 2020-10?
      instructions:
      - text: List all script tags with API 2020-10.
      - text: Find the script tags pointing at {src}, version 2020-10.
        slots:
          src: query.src
      - text: Show script tags updated after {updated_at_min} on 2020-10.
        slots:
          updated_at_min: query.updated_at_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/script_tags/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count storefront script tags (API 2020-10)
      effect: read
      questions:
      - How many script tags are on my Shopify storefront in total?
      - Can the 2020-10 API count script tags for a given source URL?
      instructions:
      - text: Count all script tags with API 2020-10.
      - text: Count the script tags pointing to {src}, version 2020-10.
        slots:
          src: query.src
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/script_tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List storefront script tags (API 2021-01)
      effect: read
      questions:
      - Which script tags does release 2021-01 report for my storefront?
      - Can 2021-01 return only certain fields of each script tag?
      instructions:
      - text: Fetch script tags through the 2021-01 release.
      - text: Using 2021-01, list script tags showing only {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/script_tags/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count storefront script tags (API 2021-01)
      effect: read
      questions:
      - What script tag total does release 2021-01 report?
      - Can I count script tags matching a source URL using 2021-01?
      instructions:
      - text: Fetch the number of script tags through 2021-01.
      - text: Using 2021-01, count script tags with src {src}.
        slots:
          src: query.src
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/script_tags.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List storefront script tags (unstable API)
      effect: read
      questions:
      - What script tags does the unstable API return for my store?
      - Can the unstable release list script tags updated before a date?
      instructions:
      - text: List script tags from the unstable API.
      - text: Get script tags last updated before {updated_at_max} on the unstable version.
        slots:
          updated_at_max: query.updated_at_max
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/script_tags/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count storefront script tags (unstable API)
      effect: read
      questions:
      - How many script tags does the unstable API count?
      - Can the unstable release count script tags by source?
      instructions:
      - text: Count script tags on the unstable API.
      - text: From the unstable version, count script tags loading {src}.
        slots:
          src: query.src
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/orders/{order_id}/risks.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fraud risks (API 2020-01)
      effect: read
      questions:
      - What fraud risk assessments are attached to an order, per API 2020-01?
      - Can I check whether one order was flagged as risky using release 2020-01?
      instructions:
      - text: List the order risks for order {order_id} using 2020-01.
        slots:
          order_id: path.order_id
      - text: Show fraud risk findings on order {order_id}, API 2020-01.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/orders/{order_id}/risks.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fraud risks (API 2020-04)
      effect: read
      questions:
      - Which risk flags has an order received, checked on version 2020-04?
      - How do I review the fraud analysis for a single order with 2020-04?
      instructions:
      - text: Get all risks recorded against order {order_id} via 2020-04.
        slots:
          order_id: path.order_id
      - text: Fetch the fraud risks for order {order_id} on release 2020-04.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/orders/{order_id}/risks.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fraud risks (API 2020-07)
      effect: read
      questions:
      - Can the 2020-07 API tell me the risk level recorded on an order?
      - What order risks exist for a suspicious purchase under version 2020-07?
      instructions:
      - text: Retrieve order {order_id}'s risk assessments with 2020-07.
        slots:
          order_id: path.order_id
      - text: On 2020-07, list every order risk for order {order_id}.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/orders/{order_id}/risks.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fraud risks (API 2020-10)
      effect: read
      questions:
      - How do I see the fraud risk assessments on a Shopify order?
      - Is an order flagged as high risk, according to the 2020-10 API?
      instructions:
      - text: List all order risks for order {order_id} with API 2020-10.
        slots:
          order_id: path.order_id
      - text: Check the fraud risks on order {order_id}, version 2020-10.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/orders/{order_id}/risks.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fraud risks (API 2021-01)
      effect: read
      questions:
      - Which fraud risks does release 2021-01 show for a given order?
      - Can I pull an order's risk recommendations using version 2021-01?
      instructions:
      - text: Fetch risks for order {order_id} through the 2021-01 release.
        slots:
          order_id: path.order_id
      - text: Using 2021-01, get the risk assessments on order {order_id}.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/orders/{order_id}/risks.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fraud risks (unstable API)
      effect: read
      questions:
      - What order risks does the unstable API list for one order?
      - Can the unstable release show whether an order looks fraudulent?
      instructions:
      - text: List order risks for order {order_id} from the unstable API.
        slots:
          order_id: path.order_id
      - text: Get fraud risk details for order {order_id} on the unstable version.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/users.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List staff accounts (API 2020-01)
      effect: read
      questions:
      - Which staff users have access to my store admin, per API 2020-01?
      - How many staff accounts can one page return with release 2020-01?
      instructions:
      - text: List all staff users using the 2020-01 API.
      - text: Show {limit} staff accounts per page, API 2020-01.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/users.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List staff accounts (API 2020-04)
      effect: read
      questions:
      - Who are the staff members on my shop, checked with version 2020-04?
      - Can I page through store users with a cursor on 2020-04?
      instructions:
      - text: Get every store staff user via release 2020-04.
      - text: Fetch the next page of users using cursor {page_info}, 2020-04.
        slots:
          page_info: query.page_info
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/users.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List staff accounts (API 2020-07)
      effect: read
      questions:
      - How do I list the admin users on my store with API 2020-07?
      - What's the page size limit for staff users under version 2020-07?
      instructions:
      - text: Retrieve all staff accounts with 2020-07.
      - text: On 2020-07, list up to {limit} store users.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/users.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List staff accounts (API 2020-10)
      effect: read
      questions:
      - Who are all the staff users with access to my Shopify Plus store?
      - Can I paginate the staff user list on API 2020-10?
      instructions:
      - text: List all staff users with API 2020-10.
      - text: Get the page of staff users at cursor {page_info}, version 2020-10.
        slots:
          page_info: query.page_info
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/users.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List staff accounts (API 2021-01)
      effect: read
      questions:
      - Which admin staff accounts does release 2021-01 return?
      - Can I limit how many staff users come back using 2021-01?
      instructions:
      - text: Fetch store staff users through the 2021-01 release.
      - text: Using 2021-01, return at most {limit} staff accounts.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/users.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List staff accounts (unstable API)
      effect: read
      questions:
      - What staff users does the unstable API list for my store?
      - Can I page through staff accounts on the unstable release?
      instructions:
      - text: List staff users from the unstable API.
      - text: Continue listing staff users from cursor {page_info} on the unstable version.
        slots:
          page_info: query.page_info
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/products/{product_id}/images.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's images (API 2020-01)
      effect: read
      questions:
      - What images are attached to one product, per API version 2020-01?
      - Can I fetch only some fields of a product's images with release 2020-01?
      instructions:
      - text: List all images of product {product_id} using 2020-01.
        slots:
          product_id: path.product_id
      - text: Show {fields} for product {product_id}'s images, API 2020-01.
        slots:
          product_id: path.product_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/products/{product_id}/images/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a product's images (API 2020-01)
      effect: read
      questions:
      - How many images does one product have, counted with API 2020-01?
      - Can version 2020-01 count only product images after a certain ID?
      instructions:
      - text: Count the images on product {product_id} using 2020-01.
        slots:
          product_id: path.product_id
      - text: Count product {product_id} images newer than ID {since_id}, API 2020-01.
        slots:
          product_id: path.product_id
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/products/{product_id}/images.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's images (API 2020-04)
      effect: read
      questions:
      - Which photos does a product have, checked on version 2020-04?
      - Can I list product images added after a known image ID on 2020-04?
      instructions:
      - text: Get the images for product {product_id} via 2020-04.
        slots:
          product_id: path.product_id
      - text: Fetch product {product_id} images after ID {since_id}, release 2020-04.
        slots:
          product_id: path.product_id
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/products/{product_id}/images/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a product's images (API 2020-04)
      effect: read
      questions:
      - What's the photo total for a single product on release 2020-04?
      - Is there a product image count endpoint in version 2020-04?
      instructions:
      - text: Get the image count for product {product_id} via 2020-04.
        slots:
          product_id: path.product_id
      - text: Tally pictures attached to product {product_id}, release 2020-04.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/products/{product_id}/images.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's images (API 2020-07)
      effect: read
      questions:
      - How do I pull every picture for a product with API 2020-07?
      - Does 2020-07 let me trim the fields returned for product images?
      instructions:
      - text: Retrieve product {product_id}'s images with 2020-07.
        slots:
          product_id: path.product_id
      - text: On 2020-07, return only {fields} of the images on product {product_id}.
        slots:
          product_id: path.product_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/products/{product_id}/images/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a product's images (API 2020-07)
      effect: read
      questions:
      - How many pictures are on a given product, per the 2020-07 API?
      - Can I count a product's images beyond a known image with 2020-07?
      instructions:
      - text: Return how many images product {product_id} has on 2020-07.
        slots:
          product_id: path.product_id
      - text: On API 2020-07, count images of product {product_id} after {since_id}.
        slots:
          product_id: path.product_id
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/products/{product_id}/images.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's images (API 2020-10)
      effect: read
      questions:
      - How do I get all the images for a product in my Shopify catalog?
      - Can the 2020-10 API return product images newer than a given image ID?
      instructions:
      - text: List every image of product {product_id} with API 2020-10.
        slots:
          product_id: path.product_id
      - text: Get product {product_id} images after image {since_id}, version 2020-10.
        slots:
          product_id: path.product_id
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/products/{product_id}/images/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a product's images (API 2020-10)
      effect: read
      questions:
      - How many images does a product in my Shopify store have?
      - Can the 2020-10 API count product images without downloading them?
      instructions:
      - text: Count all images of product {product_id} with API 2020-10.
        slots:
          product_id: path.product_id
      - text: Count images on product {product_id} after image ID {since_id}, version 2020-10.
        slots:
          product_id: path.product_id
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/products/{product_id}/images.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's images (API 2021-01)
      effect: read
      questions:
      - Which images belong to a given product according to release 2021-01?
      - Can 2021-01 limit a product's image list to certain fields?
      instructions:
      - text: Fetch images for product {product_id} through 2021-01.
        slots:
          product_id: path.product_id
      - text: Using 2021-01, list product {product_id}'s images with fields {fields}.
        slots:
          product_id: path.product_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/products/{product_id}/images/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a product's images (API 2021-01)
      effect: read
      questions:
      - What image count does release 2021-01 report for one product?
      - Can I get a product's number of photos using version 2021-01?
      instructions:
      - text: Fetch the image total for product {product_id} through 2021-01.
        slots:
          product_id: path.product_id
      - text: Using 2021-01, tell me how many pictures product {product_id} has.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/products/{product_id}/images.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's images (unstable API)
      effect: read
      questions:
      - What images does the unstable API list for a product?
      - Can I page product images past an ID on the unstable release?
      instructions:
      - text: List product {product_id}'s images from the unstable API.
        slots:
          product_id: path.product_id
      - text: Get images of product {product_id} after ID {since_id}, unstable version.
        slots:
          product_id: path.product_id
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/products/{product_id}/images/count.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a product's images (unstable API)
      effect: read
      questions:
      - How many images does the unstable API count for a product?
      - Can the unstable release count product images after an ID?
      instructions:
      - text: Count product {product_id}'s images on the unstable API.
        slots:
          product_id: path.product_id
      - text: From the unstable version, count images of product {product_id} past {since_id}.
        slots:
          product_id: path.product_id
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/shopify_payments/disputes.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments disputes (API 2020-01)
      effect: read
      questions:
      - Which chargebacks and inquiries have customers opened against my Shopify Payments account on API 2020-01?
      - Can I filter payment disputes by status with release 2020-01?
      instructions:
      - text: List all payment disputes using the 2020-01 API.
      - text: Show disputes with status {status}, API 2020-01.
        slots:
          status: query.status
      - text: Get disputes initiated on {initiated_at} via 2020-01.
        slots:
          initiated_at: query.initiated_at
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/shopify_payments/disputes.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments disputes (API 2020-04)
      effect: read
      questions:
      - What payment disputes are open on my store, checked with version 2020-04?
      - Can the 2020-04 API return only disputes started on a certain date?
      instructions:
      - text: Get every Shopify Payments dispute via release 2020-04.
      - text: Fetch disputes in status {status} on 2020-04.
        slots:
          status: query.status
      - text: List disputes after ID {since_id} with version 2020-04.
        slots:
          since_id: query.since_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/shopify_payments/payouts.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments payouts (API 2020-01)
      effect: read
      questions:
      - What payouts has my store received from Shopify Payments, per API 2020-01?
      - Can I see payouts within a date range using release 2020-01?
      instructions:
      - text: List all payouts using the 2020-01 API.
      - text: Show payouts made between {date_min} and {date_max}, API 2020-01.
        slots:
          date_min: query.date_min
          date_max: query.date_max
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/shopify_payments/payouts.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments payouts (API 2020-04)
      effect: read
      questions:
      - Which bank payouts went out to me, checked on version 2020-04?
      - Can I filter payouts by status with 2020-04?
      instructions:
      - text: Get every payout via release 2020-04.
      - text: Fetch payouts with status {status} on 2020-04.
        slots:
          status: query.status
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/shopify_payments/payouts.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments payouts (API 2020-07)
      effect: read
      questions:
      - How do I review my payout history with API 2020-07?
      - Can the 2020-07 API show the payout made on one particular day?
      instructions:
      - text: Retrieve my payouts with 2020-07.
      - text: On 2020-07, list payouts made on {date}.
        slots:
          date: query.date
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/shopify_payments/payouts.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments payouts (API 2020-10)
      effect: read
      questions:
      - What payouts has Shopify Payments sent to my bank account?
      - Can I list only payouts that failed or are still pending on API 2020-10?
      - Which payouts landed after a certain date, per version 2020-10?
      instructions:
      - text: List all payouts, newest first, with API 2020-10.
      - text: Show payouts in status {status}, version 2020-10.
        slots:
          status: query.status
      - text: Get payouts made on or after {date_min} using 2020-10.
        slots:
          date_min: query.date_min
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/shopify_payments/payouts.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments payouts (API 2021-01)
      effect: read
      questions:
      - Which payouts does release 2021-01 report for my store?
      - Can 2021-01 return payouts made before a given date?
      instructions:
      - text: Fetch payouts through the 2021-01 release.
      - text: Using 2021-01, list payouts made on or before {date_max}.
        slots:
          date_max: query.date_max
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/shopify_payments/payouts.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments payouts (unstable API)
      effect: read
      questions:
      - What payouts does the unstable API list?
      - Can I page payouts older than a known payout ID on the unstable release?
      instructions:
      - text: List payouts from the unstable API.
      - text: Get payouts before ID {last_id} on the unstable version.
        slots:
          last_id: query.last_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/shopify_payments/balance/transactions.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List Shopify Payments balance transactions (API 2020-01)
      effect: read
      questions:
      - Which charges, refunds and adjustments make up my Shopify Payments balance on API 2020-01?
      - Can I see the transactions that went into one specific payout?
      - Is it possible to show only test-mode balance transactions?
      instructions:
      - text: List all balance transactions using API 2020-01.
      - text: Show the balance transactions paid out in payout {payout_id}.
        slots:
          payout_id: query.payout_id
      - text: Get balance transactions with payout status {payout_status}, version 2020-01.
        slots:
          payout_status: query.payout_status
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/shipping_zones.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List shipping zones (API 2020-01)
      effect: read
      questions:
      - Which shipping zones and rates are configured on my store, per API 2020-01?
      - Can I request only some shipping zone fields with release 2020-01?
      instructions:
      - text: List all shipping zones using the 2020-01 API.
      - text: Show shipping zones with just {fields}, API 2020-01.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/shipping_zones.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List shipping zones (API 2020-04)
      effect: read
      questions:
      - What regions does my shop ship to, checked on version 2020-04?
      - Does 2020-04 let me trim the fields returned for shipping zones?
      instructions:
      - text: Get every shipping zone via release 2020-04.
      - text: Fetch shipping zones limited to {fields} on 2020-04.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/shipping_zones.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List shipping zones (API 2020-07)
      effect: read
      questions:
      - How do I see my store's shipping zones with API 2020-07?
      - Can the 2020-07 API return selected fields of each shipping zone?
      instructions:
      - text: Retrieve the shipping zones with 2020-07.
      - text: On 2020-07, list shipping zones returning only {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/shipping_zones.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List shipping zones (API 2020-10)
      effect: read
      questions:
      - What shipping zones, countries and rates are set up in my Shopify store?
      - Can the 2020-10 API return a lighter shipping zone payload with chosen fields?
      instructions:
      - text: List all shipping zones with API 2020-10.
      - text: Show shipping zones including only {fields}, version 2020-10.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/shipping_zones.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List shipping zones (API 2021-01)
      effect: read
      questions:
      - Which shipping zones does release 2021-01 report for my shop?
      - Can I narrow the shipping zone fields using 2021-01?
      instructions:
      - text: Fetch shipping zones through the 2021-01 release.
      - text: Using 2021-01, get shipping zones with fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/shipping_zones.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List shipping zones (unstable API)
      effect: read
      questions:
      - What shipping zones does the unstable API list for my store?
      - Can the unstable release return shipping zones with selected fields?
      instructions:
      - text: List shipping zones from the unstable API.
      - text: Get shipping zones on the unstable version showing {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-24'