# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Shopify Collection API
  version: 1.0.0
extends: openapi/shopify-collection-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: 72
- target: $.paths['/admin/api/2020-01/collects.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a product to a custom collection (2020-01)
      effect: write
      questions:
      - Can I add a product to a custom collection through the 2020-01 Admin API?
      - What call links a product into a manual collection on API version 2020-01?
      instructions:
      - text: Add a product to one of my custom collections using the 2020-01 API.
      - text: Create a 2020-01 collect that places a product in a custom collection.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/collects/{collect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from a collection (2020-01)
      effect: destructive
      questions:
      - How do I take a product out of a collection with the 2020-01 API?
      - Does the 2020-01 API let me remove a product from a collection by its collect ID?
      instructions:
      - text: Remove collect {collect} using API version 2020-01.
        slots:
          collect: path.collect_id
      - text: Delete the 2020-01 collect {collect} so that product leaves its collection.
        slots:
          collect: path.collect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/collects.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a product to a custom collection (2020-04)
      effect: write
      questions:
      - Could I put a product into a custom collection with version 2020-04?
      - Does the 2020-04 release still let me create collects for custom collections?
      instructions:
      - text: Place a product into a custom collection via the 2020-04 collects endpoint.
      - text: Link a product to a hand-picked collection on API version 2020-04.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/collects/{collect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from a collection (2020-04)
      effect: destructive
      questions:
      - What 2020-04 call removes a product from a collection?
      - Can I unlink a product from a custom collection on version 2020-04?
      instructions:
      - text: Delete collect {collect} through the 2020-04 API.
        slots:
          collect: path.collect_id
      - text: Take the product in collect {collect} out of its collection on 2020-04.
        slots:
          collect: path.collect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/collects.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a product to a custom collection (2020-07)
      effect: write
      questions:
      - Which 2020-07 endpoint adds a product to a custom collection?
      - Can the 2020-07 Admin API attach an item to a manually curated collection?
      instructions:
      - text: Attach a product to a custom collection with the 2020-07 API.
      - text: Make a new collect in 2020-07 so a product shows up in a custom collection.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/collects/{collect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from a collection (2020-07)
      effect: destructive
      questions:
      - Which endpoint in 2020-07 drops a product from a collection?
      - Is removing a collect the way to pull an item from a collection in 2020-07?
      instructions:
      - text: Drop collect {collect} with the 2020-07 Admin API.
        slots:
          collect: path.collect_id
      - text: Pull the product linked by collect {collect} out of the collection, version 2020-07.
        slots:
          collect: path.collect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/collects.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a product to a custom collection (2020-10)
      effect: write
      questions:
      - How can I add a product to a custom collection on the 2020-10 API version?
      - What creates a collect record in Shopify's 2020-10 Admin API?
      instructions:
      - text: Add a product to a custom collection using version 2020-10.
      - text: Create a collect on 2020-10 to put a product into a manual collection.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/collects/{collect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from a collection (2020-10)
      effect: destructive
      questions:
      - How can I remove a product from a collection in version 2020-10?
      - Can I delete a single collect by ID on the 2020-10 API?
      instructions:
      - text: Delete collect {collect} on version 2020-10.
        slots:
          collect: path.collect_id
      - text: Remove the product tied to collect {collect} from its collection via 2020-10.
        slots:
          collect: path.collect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/collects.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a product to a custom collection (2021-01)
      effect: write
      questions:
      - Is there a 2021-01 call for adding products to a custom collection?
      - How would I create a collect with the 2021-01 Admin API?
      instructions:
      - text: Put a product in a custom collection through the 2021-01 API.
      - text: Create a collect under version 2021-01 linking a product to a custom collection.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/collects/{collect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from a collection (2021-01)
      effect: destructive
      questions:
      - Is there a 2021-01 endpoint to remove a product from a collection?
      - Can the 2021-01 API delete a collect by its ID?
      instructions:
      - text: Remove collect {collect} using the 2021-01 release.
        slots:
          collect: path.collect_id
      - text: Unlink the product in collect {collect} from its collection on 2021-01.
        slots:
          collect: path.collect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/collects.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a product to a custom collection (unstable)
      effect: write
      questions:
      - Can I add products to a custom collection on the unstable API version?
      - Which unstable-version call creates a collect for a custom collection?
      instructions:
      - text: Add a product to a custom collection using the unstable API.
      - text: Create a collect on the unstable version for a hand-picked collection.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/collects/{collect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from a collection (unstable)
      effect: destructive
      questions:
      - How would I remove a product from a collection with the unstable API?
      - Which unstable-version call deletes a collect?
      instructions:
      - text: Delete collect {collect} on the unstable API version.
        slots:
          collect: path.collect_id
      - text: Take collect {collect} out using the unstable endpoint.
        slots:
          collect: path.collect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/collections/{collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get any collection by ID (2020-01)
      effect: read
      questions:
      - Can I look up a collection by ID, custom or smart, with the 2020-01 API?
      - Can the 2020-01 collections endpoint return only certain fields of a collection?
      instructions:
      - text: Get collection {collection}, whatever its type, using API version 2020-01.
        slots:
          collection: path.collection_id
      - text: Fetch collection {collection} on 2020-01 with only the fields {fields}.
        slots:
          collection: path.collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/collections/{collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get any collection by ID (2020-04)
      effect: read
      questions:
      - Which 2020-04 call retrieves any single collection regardless of type?
      - Can I fetch a collection by its ID without knowing if it's smart or custom, on 2020-04?
      instructions:
      - text: Retrieve collection {collection} of any type through the 2020-04 API.
        slots:
          collection: path.collection_id
      - text: Show me the {fields} of collection {collection} using version 2020-04.
        slots:
          collection: path.collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/collections/{collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get any collection by ID (2020-07)
      effect: read
      questions:
      - What's the 2020-07 endpoint for reading one collection of any kind?
      - Does 2020-07 let me limit which fields come back when I retrieve a generic collection?
      instructions:
      - text: Look up collection {collection}, smart or custom, with version 2020-07.
        slots:
          collection: path.collection_id
      - text: Return just {fields} for collection {collection} from the 2020-07 API.
        slots:
          collection: path.collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/collections/{collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get any collection by ID (2020-10)
      effect: read
      questions:
      - How can I retrieve a single collection, smart or custom, on version 2020-10?
      - Can I read any collection's details by ID through the 2020-10 Admin API?
      instructions:
      - text: Retrieve collection {collection} on 2020-10 regardless of its type.
        slots:
          collection: path.collection_id
      - text: Get the fields {fields} of collection {collection} via 2020-10.
        slots:
          collection: path.collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/collections/{collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get any collection by ID (2021-01)
      effect: read
      questions:
      - Is there a 2021-01 call to get one collection whatever its type?
      - Can I choose the fields returned for a general collection lookup in 2021-01?
      instructions:
      - text: Fetch collection {collection} of either type using the 2021-01 release.
        slots:
          collection: path.collection_id
      - text: Pull {fields} from collection {collection} with the 2021-01 API.
        slots:
          collection: path.collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/collections/{collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get any collection by ID (unstable)
      effect: read
      questions:
      - How would I get a single collection of any type from the unstable API?
      - Which unstable endpoint returns a collection by its ID whether it is smart or custom?
      instructions:
      - text: Get collection {collection}, custom or smart, from the unstable version.
        slots:
          collection: path.collection_id
      - text: Look up {fields} on collection {collection} using the unstable API.
        slots:
          collection: path.collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/custom_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom collection (2020-01)
      effect: write
      questions:
      - Can I create a hand-picked custom collection with the 2020-01 Admin API?
      - What 2020-01 call sets up a brand-new custom collection?
      instructions:
      - text: Create a new custom collection using API version 2020-01.
      - text: Set up a manual collection for my store on 2020-01.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/custom_collections/{custom_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom collection (2020-01)
      effect: read
      questions:
      - How do I retrieve one custom collection by ID on 2020-01?
      - Can the 2020-01 custom collections endpoint return selected fields only?
      instructions:
      - text: Get custom collection {custom_collection} with API version 2020-01.
        slots:
          custom_collection: path.custom_collection_id
      - text: Fetch {fields} for custom collection {custom_collection} on 2020-01.
        slots:
          custom_collection: path.custom_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/custom_collections/{custom_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom collection (2020-01)
      effect: write
      questions:
      - Can I edit an existing custom collection with the 2020-01 API?
      - What 2020-01 call changes a custom collection I already made?
      instructions:
      - text: Update custom collection {custom_collection} using API version 2020-01.
        slots:
          custom_collection: path.custom_collection_id
      - text: Edit my existing custom collection {custom_collection} on 2020-01.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/custom_collections/{custom_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom collection (2020-01)
      effect: destructive
      questions:
      - How do I delete a custom collection with the 2020-01 API?
      - Can I permanently remove a manual collection on 2020-01?
      instructions:
      - text: Delete custom collection {custom_collection} using API version 2020-01.
        slots:
          custom_collection: path.custom_collection_id
      - text: Permanently remove custom collection {custom_collection} on 2020-01.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/custom_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom collection (2020-04)
      effect: write
      questions:
      - What's involved in making a custom collection on version 2020-04?
      - Which 2020-04 endpoint creates a manually curated collection?
      instructions:
      - text: Make a custom collection through the 2020-04 API.
      - text: Add a new hand-curated collection to the store with 2020-04.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/custom_collections/{custom_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom collection (2020-04)
      effect: read
      questions:
      - Which 2020-04 call reads a single custom collection?
      - Can I look up a manual collection's details by its ID in 2020-04?
      instructions:
      - text: Retrieve custom collection {custom_collection} via the 2020-04 API.
        slots:
          custom_collection: path.custom_collection_id
      - text: Show the {fields} of custom collection {custom_collection} on 2020-04.
        slots:
          custom_collection: path.custom_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/custom_collections/{custom_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom collection (2020-04)
      effect: write
      questions:
      - What's the way to modify a custom collection on version 2020-04?
      - Which 2020-04 endpoint saves changes to a manual collection?
      instructions:
      - text: Modify custom collection {custom_collection} through the 2020-04 API.
        slots:
          custom_collection: path.custom_collection_id
      - text: Save changes to custom collection {custom_collection} with 2020-04.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/custom_collections/{custom_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom collection (2020-04)
      effect: destructive
      questions:
      - Which 2020-04 call deletes a custom collection?
      - Is there a way to get rid of a curated collection in 2020-04?
      instructions:
      - text: Remove custom collection {custom_collection} through the 2020-04 API.
        slots:
          custom_collection: path.custom_collection_id
      - text: Get rid of custom collection {custom_collection} with 2020-04.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/custom_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom collection (2020-07)
      effect: write
      questions:
      - Is creating a custom collection supported in the 2020-07 release?
      - What endpoint builds a new manual collection on 2020-07?
      instructions:
      - text: Create a custom collection with version 2020-07.
      - text: Start a fresh hand-picked collection via the 2020-07 Admin API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/custom_collections/{custom_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom collection (2020-07)
      effect: read
      questions:
      - What 2020-07 endpoint returns one custom collection?
      - Does version 2020-07 let me trim the fields on a custom collection lookup?
      instructions:
      - text: Look up custom collection {custom_collection} using 2020-07.
        slots:
          custom_collection: path.custom_collection_id
      - text: Return only {fields} for custom collection {custom_collection} from 2020-07.
        slots:
          custom_collection: path.custom_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/custom_collections/{custom_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom collection (2020-07)
      effect: write
      questions:
      - Is updating a custom collection possible in 2020-07?
      - What endpoint in 2020-07 edits an existing curated collection?
      instructions:
      - text: Edit custom collection {custom_collection} using version 2020-07.
        slots:
          custom_collection: path.custom_collection_id
      - text: Apply updates to custom collection {custom_collection} via the 2020-07 Admin API.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/custom_collections/{custom_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom collection (2020-07)
      effect: destructive
      questions:
      - What 2020-07 endpoint removes a custom collection entirely?
      - Can I delete a hand-picked collection using version 2020-07?
      instructions:
      - text: Delete custom collection {custom_collection} via version 2020-07.
        slots:
          custom_collection: path.custom_collection_id
      - text: Wipe out custom collection {custom_collection} using the 2020-07 Admin API.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/custom_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom collection (2020-10)
      effect: write
      questions:
      - How can I create a custom collection on the 2020-10 API?
      - Which 2020-10 call adds a new curated collection to my shop?
      instructions:
      - text: Create a new custom collection on 2020-10.
      - text: Build a manual product collection using the 2020-10 endpoint.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/custom_collections/{custom_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom collection (2020-10)
      effect: read
      questions:
      - How can I view a single custom collection in version 2020-10?
      - Can I get a hand-picked collection by ID from the 2020-10 Admin API?
      instructions:
      - text: Retrieve custom collection {custom_collection} on 2020-10.
        slots:
          custom_collection: path.custom_collection_id
      - text: Get {fields} of custom collection {custom_collection} via version 2020-10.
        slots:
          custom_collection: path.custom_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/custom_collections/{custom_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom collection (2020-10)
      effect: write
      questions:
      - How can I update a custom collection in the 2020-10 release?
      - Which 2020-10 call rewrites an existing hand-picked collection?
      instructions:
      - text: Update custom collection {custom_collection} on 2020-10.
        slots:
          custom_collection: path.custom_collection_id
      - text: Change the details of custom collection {custom_collection} via version 2020-10.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/custom_collections/{custom_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom collection (2020-10)
      effect: destructive
      questions:
      - How can I delete a custom collection on 2020-10?
      - Which 2020-10 call permanently removes a manual collection?
      instructions:
      - text: Delete custom collection {custom_collection} on 2020-10.
        slots:
          custom_collection: path.custom_collection_id
      - text: Remove the custom collection {custom_collection} for good via version 2020-10.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/custom_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom collection (2021-01)
      effect: write
      questions:
      - Can I add a new custom collection through the 2021-01 API?
      - Where do I create a curated collection in version 2021-01?
      instructions:
      - text: Set up a custom collection with the 2021-01 release.
      - text: Create a hand-picked collection on API version 2021-01.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/custom_collections/{custom_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom collection (2021-01)
      effect: read
      questions:
      - Is there a 2021-01 call to read one custom collection?
      - Can I request specific fields of a custom collection in 2021-01?
      instructions:
      - text: Fetch custom collection {custom_collection} with the 2021-01 release.
        slots:
          custom_collection: path.custom_collection_id
      - text: Pull {fields} from custom collection {custom_collection} using 2021-01.
        slots:
          custom_collection: path.custom_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/custom_collections/{custom_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom collection (2021-01)
      effect: write
      questions:
      - Can the 2021-01 API change an existing custom collection?
      - Where do I update a manual collection in version 2021-01?
      instructions:
      - text: Modify custom collection {custom_collection} with the 2021-01 release.
        slots:
          custom_collection: path.custom_collection_id
      - text: Push edits to custom collection {custom_collection} using 2021-01.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/custom_collections/{custom_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom collection (2021-01)
      effect: destructive
      questions:
      - Can the 2021-01 API delete a custom collection?
      - Where is the custom collection delete call in 2021-01?
      instructions:
      - text: Remove custom collection {custom_collection} with the 2021-01 release.
        slots:
          custom_collection: path.custom_collection_id
      - text: Delete my custom collection {custom_collection} using 2021-01.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/custom_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom collection (unstable)
      effect: write
      questions:
      - Does the unstable API let me create a custom collection?
      - What's the unstable-version call for a new manual collection?
      instructions:
      - text: Create a custom collection using the unstable version.
      - text: Add a curated collection through the unstable Admin API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/custom_collections/{custom_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom collection (unstable)
      effect: read
      questions:
      - How would I fetch a custom collection from the unstable API?
      - Which unstable endpoint returns one manual collection?
      instructions:
      - text: Get custom collection {custom_collection} from the unstable version.
        slots:
          custom_collection: path.custom_collection_id
      - text: Look up the {fields} on custom collection {custom_collection} with the unstable API.
        slots:
          custom_collection: path.custom_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/custom_collections/{custom_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom collection (unstable)
      effect: write
      questions:
      - Does the unstable version support editing a custom collection?
      - What's the unstable call for updating a curated collection?
      instructions:
      - text: Update custom collection {custom_collection} on the unstable API.
        slots:
          custom_collection: path.custom_collection_id
      - text: Edit the existing custom collection {custom_collection} via the unstable version.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/custom_collections/{custom_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom collection (unstable)
      effect: destructive
      questions:
      - Does the unstable version let me delete a custom collection?
      - What unstable endpoint removes a curated collection?
      instructions:
      - text: Delete custom collection {custom_collection} on the unstable API.
        slots:
          custom_collection: path.custom_collection_id
      - text: Get rid of custom collection {custom_collection} via the unstable version.
        slots:
          custom_collection: path.custom_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/smart_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule-based smart collection (2020-01)
      effect: write
      questions:
      - Can I create a smart collection driven by rules with the 2020-01 API?
      - What 2020-01 call builds an automated collection from conditions?
      instructions:
      - text: Create a new rule-based smart collection using API version 2020-01.
      - text: Set up an automated smart collection on 2020-01.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/smart_collections/{smart_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a smart collection (2020-01)
      effect: read
      questions:
      - Can I read a single automated smart collection with the 2020-01 API?
      - Does the 2020-01 smart collections endpoint let me pick which fields return?
      instructions:
      - text: Get smart collection {smart_collection} using the 2020-01 release.
        slots:
          smart_collection: path.smart_collection_id
      - text: Fetch the {fields} for smart collection {smart_collection} on version 2020-01.
        slots:
          smart_collection: path.smart_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/smart_collections/{smart_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a smart collection (2020-01)
      effect: write
      questions:
      - Can I edit an existing smart collection with the 2020-01 API?
      - What 2020-01 call saves changes to an automated collection?
      instructions:
      - text: Update smart collection {smart_collection} using API version 2020-01.
        slots:
          smart_collection: path.smart_collection_id
      - text: Edit my smart collection {smart_collection} on 2020-01.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/smart_collections/{smart_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a smart collection (2020-01)
      effect: destructive
      questions:
      - How do I remove a smart collection with the 2020-01 API?
      - Can I permanently delete an automated collection on 2020-01?
      instructions:
      - text: Delete smart collection {smart_collection} using API version 2020-01.
        slots:
          smart_collection: path.smart_collection_id
      - text: Permanently remove smart collection {smart_collection} on 2020-01.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/smart_collections/{smart_collection_id}/order.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Set product ordering in a smart collection (2020-01)
      effect: write
      questions:
      - Can I change how products are sorted inside a smart collection with the 2020-01 API?
      - Is it possible to pin specific products to the top of a smart collection on 2020-01?
      instructions:
      - text: Set the sort order of smart collection {smart_collection} to {sort_order} using 2020-01.
        slots:
          smart_collection: path.smart_collection_id
          sort_order: query.sort_order
      - text: Pin products {products} to the top of smart collection {smart_collection} on version 2020-01.
        slots:
          smart_collection: path.smart_collection_id
          products: query.products
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/smart_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule-based smart collection (2020-04)
      effect: write
      questions:
      - How do I make a smart collection that fills itself by rules on 2020-04?
      - Which 2020-04 endpoint creates an automatic collection?
      instructions:
      - text: Make a smart collection with rules through the 2020-04 API.
      - text: Add an automated collection to the store with 2020-04.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/smart_collections/{smart_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a smart collection (2020-04)
      effect: read
      questions:
      - Which 2020-04 endpoint shows one rule-based collection?
      - Can I look up an automated collection by its ID in 2020-04?
      instructions:
      - text: Retrieve smart collection {smart_collection} via 2020-04.
        slots:
          smart_collection: path.smart_collection_id
      - text: Show only {fields} of smart collection {smart_collection} with the 2020-04 API.
        slots:
          smart_collection: path.smart_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/smart_collections/{smart_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a smart collection (2020-04)
      effect: write
      questions:
      - Could I modify a smart collection on version 2020-04?
      - Which 2020-04 endpoint edits a rule-based collection?
      instructions:
      - text: Modify smart collection {smart_collection} through the 2020-04 API.
        slots:
          smart_collection: path.smart_collection_id
      - text: Save edits to smart collection {smart_collection} with 2020-04.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/smart_collections/{smart_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a smart collection (2020-04)
      effect: destructive
      questions:
      - Which 2020-04 call removes a smart collection?
      - Is there a way to get rid of a rule-based collection in 2020-04?
      instructions:
      - text: Remove smart collection {smart_collection} through the 2020-04 API.
        slots:
          smart_collection: path.smart_collection_id
      - text: Get rid of smart collection {smart_collection} with 2020-04.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/smart_collections/{smart_collection_id}/order.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Set product ordering in a smart collection (2020-04)
      effect: write
      questions:
      - How do I reorder the products in a smart collection on 2020-04?
      - Which 2020-04 call sets the sorting type of an automated collection?
      instructions:
      - text: Change smart collection {smart_collection} to sort by {sort_order} via the 2020-04 API.
        slots:
          smart_collection: path.smart_collection_id
          sort_order: query.sort_order
      - text: Put products {products} first in smart collection {smart_collection} with 2020-04.
        slots:
          smart_collection: path.smart_collection_id
          products: query.products
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/smart_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule-based smart collection (2020-07)
      effect: write
      questions:
      - Is creating a rule-driven smart collection supported in 2020-07?
      - What endpoint sets up an automatic collection on version 2020-07?
      instructions:
      - text: Create a smart collection using version 2020-07.
      - text: Start a new rules-based collection via the 2020-07 Admin API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/smart_collections/{smart_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a smart collection (2020-07)
      effect: read
      questions:
      - What 2020-07 call returns one smart collection?
      - Is there a way to limit fields when reading a smart collection on 2020-07?
      instructions:
      - text: Look up smart collection {smart_collection} with the 2020-07 Admin API.
        slots:
          smart_collection: path.smart_collection_id
      - text: Return {fields} for smart collection {smart_collection} using version 2020-07.
        slots:
          smart_collection: path.smart_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/smart_collections/{smart_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a smart collection (2020-07)
      effect: write
      questions:
      - Is updating a smart collection possible in 2020-07?
      - What endpoint in 2020-07 changes an existing automatic collection?
      instructions:
      - text: Edit smart collection {smart_collection} using version 2020-07.
        slots:
          smart_collection: path.smart_collection_id
      - text: Apply changes to smart collection {smart_collection} via the 2020-07 Admin API.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/smart_collections/{smart_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a smart collection (2020-07)
      effect: destructive
      questions:
      - What 2020-07 endpoint deletes a smart collection entirely?
      - Can I remove an automatic collection using version 2020-07?
      instructions:
      - text: Delete smart collection {smart_collection} via version 2020-07.
        slots:
          smart_collection: path.smart_collection_id
      - text: Wipe out smart collection {smart_collection} using the 2020-07 Admin API.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/smart_collections/{smart_collection_id}/order.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Set product ordering in a smart collection (2020-07)
      effect: write
      questions:
      - What 2020-07 endpoint controls product ordering in a smart collection?
      - Can I manually order a few products at the top of a rule-based collection in 2020-07?
      instructions:
      - text: Apply the {sort_order} ordering to smart collection {smart_collection} on 2020-07.
        slots:
          smart_collection: path.smart_collection_id
          sort_order: query.sort_order
      - text: Move products {products} to the top of smart collection {smart_collection} using version 2020-07.
        slots:
          smart_collection: path.smart_collection_id
          products: query.products
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/smart_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule-based smart collection (2020-10)
      effect: write
      questions:
      - How can I create a smart collection with product rules on 2020-10?
      - Which 2020-10 call adds an automated collection to my shop?
      instructions:
      - text: Create a new smart collection on 2020-10.
      - text: Build a rules-driven collection using the 2020-10 endpoint.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/smart_collections/{smart_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a smart collection (2020-10)
      effect: read
      questions:
      - How can I view a single smart collection on 2020-10?
      - Can I get an automatic collection by ID through the 2020-10 API?
      instructions:
      - text: Retrieve smart collection {smart_collection} from 2020-10.
        slots:
          smart_collection: path.smart_collection_id
      - text: Get the {fields} of smart collection {smart_collection} on the 2020-10 version.
        slots:
          smart_collection: path.smart_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/smart_collections/{smart_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a smart collection (2020-10)
      effect: write
      questions:
      - What's the call to update a smart collection in the 2020-10 release?
      - Which 2020-10 call rewrites an existing rules-driven collection?
      instructions:
      - text: Update smart collection {smart_collection} on 2020-10.
        slots:
          smart_collection: path.smart_collection_id
      - text: Change the settings of smart collection {smart_collection} via version 2020-10.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/smart_collections/{smart_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a smart collection (2020-10)
      effect: destructive
      questions:
      - How can I delete a smart collection on 2020-10?
      - Which 2020-10 call permanently removes a rules-driven collection?
      instructions:
      - text: Delete smart collection {smart_collection} on 2020-10.
        slots:
          smart_collection: path.smart_collection_id
      - text: Remove the smart collection {smart_collection} for good via version 2020-10.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/smart_collections/{smart_collection_id}/order.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Set product ordering in a smart collection (2020-10)
      effect: write
      questions:
      - How can I set the product sort order for a smart collection on 2020-10?
      - Can I list specific product IDs to appear first in a smart collection via 2020-10?
      instructions:
      - text: Sort smart collection {smart_collection} by {sort_order} on 2020-10.
        slots:
          smart_collection: path.smart_collection_id
          sort_order: query.sort_order
      - text: Feature products {products} at the top of smart collection {smart_collection} via 2020-10.
        slots:
          smart_collection: path.smart_collection_id
          products: query.products
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/smart_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule-based smart collection (2021-01)
      effect: write
      questions:
      - Can I add a smart collection based on rules through the 2021-01 API?
      - Where do I create an automated collection in version 2021-01?
      instructions:
      - text: Set up a smart collection with the 2021-01 release.
      - text: Create a rule-based collection on API version 2021-01.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/smart_collections/{smart_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a smart collection (2021-01)
      effect: read
      questions:
      - Is there a 2021-01 call to read one smart collection?
      - Can I request selected fields of a rule-based collection in 2021-01?
      instructions:
      - text: Fetch smart collection {smart_collection} using 2021-01.
        slots:
          smart_collection: path.smart_collection_id
      - text: Pull {fields} off smart collection {smart_collection} with the 2021-01 release.
        slots:
          smart_collection: path.smart_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/smart_collections/{smart_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a smart collection (2021-01)
      effect: write
      questions:
      - Can the 2021-01 API change an existing smart collection?
      - Where do I update an automated collection in version 2021-01?
      instructions:
      - text: Modify smart collection {smart_collection} with the 2021-01 release.
        slots:
          smart_collection: path.smart_collection_id
      - text: Push edits to smart collection {smart_collection} using 2021-01.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/smart_collections/{smart_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a smart collection (2021-01)
      effect: destructive
      questions:
      - Can the 2021-01 API remove a smart collection?
      - Where is the smart collection delete call in 2021-01?
      instructions:
      - text: Remove smart collection {smart_collection} with the 2021-01 release.
        slots:
          smart_collection: path.smart_collection_id
      - text: Delete my smart collection {smart_collection} using 2021-01.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/smart_collections/{smart_collection_id}/order.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Set product ordering in a smart collection (2021-01)
      effect: write
      questions:
      - Does the 2021-01 API let me change the ordering type of a smart collection?
      - Can I push chosen products to the front of an automated collection with 2021-01?
      instructions:
      - text: Reorder smart collection {smart_collection} using {sort_order} with the 2021-01 release.
        slots:
          smart_collection: path.smart_collection_id
          sort_order: query.sort_order
      - text: Place products {products} ahead of the rest in smart collection {smart_collection} on 2021-01.
        slots:
          smart_collection: path.smart_collection_id
          products: query.products
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/smart_collections.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule-based smart collection (unstable)
      effect: write
      questions:
      - Does the unstable API let me create a smart collection?
      - What's the unstable-version call for a new rule-based collection?
      instructions:
      - text: Create a smart collection using the unstable version.
      - text: Add an automated rules collection through the unstable Admin API.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/smart_collections/{smart_collection_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a smart collection (unstable)
      effect: read
      questions:
      - How would I get a smart collection from the unstable API?
      - Which unstable endpoint returns one automated collection?
      instructions:
      - text: Get smart collection {smart_collection} on the unstable version.
        slots:
          smart_collection: path.smart_collection_id
      - text: Look up {fields} for smart collection {smart_collection} via the unstable API.
        slots:
          smart_collection: path.smart_collection_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/smart_collections/{smart_collection_id}.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a smart collection (unstable)
      effect: write
      questions:
      - Does the unstable version support editing a smart collection?
      - What's the unstable call for updating a rule-based collection?
      instructions:
      - text: Update smart collection {smart_collection} on the unstable API.
        slots:
          smart_collection: path.smart_collection_id
      - text: Edit the existing smart collection {smart_collection} via the unstable version.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/smart_collections/{smart_collection_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a smart collection (unstable)
      effect: destructive
      questions:
      - Does the unstable version let me delete a smart collection?
      - What unstable endpoint removes an automated collection?
      instructions:
      - text: Delete smart collection {smart_collection} on the unstable API.
        slots:
          smart_collection: path.smart_collection_id
      - text: Get rid of smart collection {smart_collection} via the unstable version.
        slots:
          smart_collection: path.smart_collection_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/smart_collections/{smart_collection_id}/order.json'].put
  update:
    x-apievangelist-phrasing:
      intent: Set product ordering in a smart collection (unstable)
      effect: write
      questions:
      - Which unstable-version call reorders products in a smart collection?
      - Can the unstable API put hand-picked products first in a smart collection?
      instructions:
      - text: Set smart collection {smart_collection} ordering to {sort_order} on the unstable API.
        slots:
          smart_collection: path.smart_collection_id
          sort_order: query.sort_order
      - text: Pin {products} at the top of smart collection {smart_collection} via the unstable version.
        slots:
          smart_collection: path.smart_collection_id
          products: query.products
      method: generated
      generated: '2026-09-24'