API Evangelist conversational phrasing for Shopify Deletes API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Shopify Deletes API
  version: 1.0.0
extends: openapi/shopify-deletes-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: 50
- target: $.paths['/admin/api/2020-01/webhooks/{webhook_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook subscription (2020-01)
      effect: destructive
      questions:
      - Can I stop a webhook subscription from firing using the 2020-01 Admin API?
      - Which ID does API version 2020-01 need to remove a webhook?
      instructions:
      - text: Delete webhook {webhook_id} through the 2020-01 API version.
        slots:
          webhook_id: path.webhook_id
      - text: Unsubscribe webhook {webhook_id} on 2020-01.
        slots:
          webhook_id: path.webhook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/webhooks/{webhook_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook subscription (2020-04)
      effect: destructive
      questions:
      - How do I unsubscribe a webhook in the April 2020 (2020-04) Admin API?
      - Is there a way to drop a webhook topic subscription on release 2020-04?
      instructions:
      - text: Remove webhook subscription {webhook_id} using version 2020-04.
        slots:
          webhook_id: path.webhook_id
      - text: Stop webhook {webhook_id} from sending notifications, 2020-04 endpoint.
        slots:
          webhook_id: path.webhook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/webhooks/{webhook_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook subscription (2020-07)
      effect: destructive
      questions:
      - Can the 2020-07 API version tear down a webhook subscription I no longer need?
      - Where do I cancel an app's webhook subscription in 2020-07?
      instructions:
      - text: Tear down webhook {webhook_id} via the 2020-07 endpoint.
        slots:
          webhook_id: path.webhook_id
      - text: On API version 2020-07, drop the webhook subscription {webhook_id}.
        slots:
          webhook_id: path.webhook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/webhooks/{webhook_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook subscription
      effect: destructive
      questions:
      - What call deletes a webhook subscription in the supported 2020-10 Admin API?
      - Can I remove a single webhook by its ID on the 2020-10 version?
      instructions:
      - text: Delete the webhook subscription {webhook_id} on 2020-10.
        slots:
          webhook_id: path.webhook_id
      - text: Using the 2020-10 Admin API, get rid of webhook {webhook_id}.
        slots:
          webhook_id: path.webhook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/webhooks/{webhook_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook subscription (2021-01)
      effect: destructive
      questions:
      - Is there a 2021-01 endpoint to remove a webhook subscription?
      - Can I clean up an old webhook on the January 2021 API version?
      instructions:
      - text: Remove webhook {webhook_id} with the 2021-01 version.
        slots:
          webhook_id: path.webhook_id
      - text: Clean up the webhook subscription {webhook_id} via 2021-01.
        slots:
          webhook_id: path.webhook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/webhooks/{webhook_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook subscription (unstable)
      effect: destructive
      questions:
      - Can I delete a webhook subscription through the unstable Admin API version?
      - Does the unstable API let me remove webhooks by ID?
      instructions:
      - text: Delete webhook {webhook_id} against the unstable API version.
        slots:
          webhook_id: path.webhook_id
      - text: Use the unstable endpoint to unsubscribe webhook {webhook_id}.
        slots:
          webhook_id: path.webhook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/inventory_levels.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item's stock level at a location (2020-01)
      effect: destructive
      questions:
      - Can I disconnect an inventory item from a location with the 2020-01 API?
      - What two IDs does the 2020-01 version need to delete an inventory level?
      instructions:
      - text: Delete the inventory level for item {inventory_item_id} at location {location_id} using 2020-01.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      - text: On version 2020-01, stop stocking item {inventory_item_id} at location {location_id}.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/inventory_levels.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item's stock level at a location (2020-04)
      effect: destructive
      questions:
      - How do I remove an inventory level for one location in the 2020-04 Admin API?
      - Can the 2020-04 release drop an item's stock record from a warehouse?
      instructions:
      - text: Remove inventory item {inventory_item_id} from location {location_id} via 2020-04.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      - text: Using 2020-04, erase the stock level record of {inventory_item_id} at {location_id}.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/inventory_levels.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item's stock level at a location (2020-07)
      effect: destructive
      questions:
      - Is it possible to unlink stock from a location with API version 2020-07?
      - Which 2020-07 endpoint deletes an item's inventory level at a store location?
      instructions:
      - text: Unlink inventory item {inventory_item_id} from location {location_id} on 2020-07.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      - text: Through the 2020-07 endpoint, wipe the inventory level of {inventory_item_id} held at {location_id}.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/inventory_levels.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item's stock level at a location
      effect: destructive
      questions:
      - Can I stop tracking a product's stock at one location on the 2020-10 version?
      - What does the 2020-10 Admin API require to delete an inventory level?
      instructions:
      - text: Delete inventory level for {inventory_item_id} at location {location_id} with version 2020-10.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      - text: Disconnect item {inventory_item_id} from warehouse {location_id} in 2020-10.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/inventory_levels.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item's stock level at a location (2021-01)
      effect: destructive
      questions:
      - Can version 2021-01 remove an inventory item from a single location?
      - Which parameters identify the inventory level to delete in 2021-01?
      instructions:
      - text: Using 2021-01, remove the inventory level of item {inventory_item_id} at {location_id}.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      - text: Take inventory item {inventory_item_id} out of location {location_id} on the 2021-01 API.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/inventory_levels.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item's stock level at a location (unstable)
      effect: destructive
      questions:
      - Does the unstable Admin API support deleting inventory levels?
      - Can I test removing an item from a location on the unstable version?
      instructions:
      - text: On the unstable API, delete inventory level {inventory_item_id} at location {location_id}.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      - text: Detach item {inventory_item_id} from location {location_id} through the unstable version.
        slots:
          inventory_item_id: query.inventory_item_id
          location_id: query.location_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/metafields/{metafield_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a metafield by ID (2020-01)
      effect: destructive
      questions:
      - Can I delete a custom metafield by its ID in the 2020-01 Admin API?
      - Which version 2020-01 call removes stored metafield data?
      instructions:
      - text: Delete metafield {metafield_id} using the 2020-01 API.
        slots:
          metafield_id: path.metafield_id
      - text: Remove the custom field {metafield_id} on version 2020-01.
        slots:
          metafield_id: path.metafield_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/metafields/{metafield_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a metafield by ID (2020-04)
      effect: destructive
      questions:
      - How do I get rid of a metafield I no longer use with API version 2020-04?
      - Is a metafield ID enough to delete it on 2020-04?
      instructions:
      - text: Using 2020-04, erase metafield {metafield_id}.
        slots:
          metafield_id: path.metafield_id
      - text: Drop metafield {metafield_id} via the 2020-04 endpoint.
        slots:
          metafield_id: path.metafield_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/metafields/{metafield_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a metafield by ID (2020-07)
      effect: destructive
      questions:
      - Can the 2020-07 release remove extra data stored in a metafield?
      - Where is the metafield delete endpoint in version 2020-07?
      instructions:
      - text: On 2020-07, delete the metafield with ID {metafield_id}.
        slots:
          metafield_id: path.metafield_id
      - text: Clear out metafield {metafield_id} through API version 2020-07.
        slots:
          metafield_id: path.metafield_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/metafields/{metafield_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a metafield by ID
      effect: destructive
      questions:
      - What call deletes a metafield by ID in the 2020-10 Admin API?
      - Can I permanently remove one metafield on version 2020-10?
      instructions:
      - text: Delete metafield {metafield_id} with the 2020-10 Admin API.
        slots:
          metafield_id: path.metafield_id
      - text: Permanently remove the metafield {metafield_id} using 2020-10.
        slots:
          metafield_id: path.metafield_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/metafields/{metafield_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a metafield by ID (2021-01)
      effect: destructive
      questions:
      - Does the January 2021 (2021-01) API let me delete a metafield?
      - Can I clean up an obsolete metafield on 2021-01?
      instructions:
      - text: Remove metafield {metafield_id} via the 2021-01 version.
        slots:
          metafield_id: path.metafield_id
      - text: With API version 2021-01, clean up metafield {metafield_id}.
        slots:
          metafield_id: path.metafield_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/metafields/{metafield_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a metafield by ID (unstable)
      effect: destructive
      questions:
      - Can I remove a metafield through the unstable Admin API?
      - Is metafield deletion available on the unstable version?
      instructions:
      - text: Delete metafield {metafield_id} against the unstable API.
        slots:
          metafield_id: path.metafield_id
      - text: Use the unstable version to discard metafield {metafield_id}.
        slots:
          metafield_id: path.metafield_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/redirects/{redirect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a URL redirect (2020-01)
      effect: destructive
      questions:
      - How do I delete a URL redirect from my online store with the 2020-01 API?
      - Can version 2020-01 remove an old path redirect?
      instructions:
      - text: Delete URL redirect {redirect_id} using 2020-01.
        slots:
          redirect_id: path.redirect_id
      - text: Remove the store redirect {redirect_id} on the 2020-01 version.
        slots:
          redirect_id: path.redirect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/redirects/{redirect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a URL redirect (2020-04)
      effect: destructive
      questions:
      - Can I stop an old URL from forwarding visitors using API version 2020-04?
      - Which ID does the 2020-04 release need to delete a redirect?
      instructions:
      - text: Stop redirect {redirect_id} from forwarding, via 2020-04.
        slots:
          redirect_id: path.redirect_id
      - text: On 2020-04, delete the online store redirect {redirect_id}.
        slots:
          redirect_id: path.redirect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/redirects/{redirect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a URL redirect (2020-07)
      effect: destructive
      questions:
      - Is there a 2020-07 endpoint for removing online store redirects?
      - Can I clean up a broken redirect with version 2020-07?
      instructions:
      - text: Remove redirect {redirect_id} through the 2020-07 API.
        slots:
          redirect_id: path.redirect_id
      - text: Clean up the broken URL redirect {redirect_id} on 2020-07.
        slots:
          redirect_id: path.redirect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/redirects/{redirect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a URL redirect
      effect: destructive
      questions:
      - What call removes a URL redirect in the 2020-10 Admin API?
      - Can I delete a redirect by its ID on version 2020-10?
      instructions:
      - text: Delete the redirect {redirect_id} with the 2020-10 Admin API.
        slots:
          redirect_id: path.redirect_id
      - text: Using 2020-10, take down URL redirect {redirect_id}.
        slots:
          redirect_id: path.redirect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/redirects/{redirect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a URL redirect (2021-01)
      effect: destructive
      questions:
      - Does API version 2021-01 support deleting a redirect?
      - Can I retire an outdated path redirect with 2021-01?
      instructions:
      - text: Retire redirect {redirect_id} via 2021-01.
        slots:
          redirect_id: path.redirect_id
      - text: Delete URL redirect {redirect_id} on the January 2021 version.
        slots:
          redirect_id: path.redirect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/redirects/{redirect_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a URL redirect (unstable)
      effect: destructive
      questions:
      - Can I delete a store redirect with the unstable Admin API?
      - Is redirect removal available in the unstable version?
      instructions:
      - text: Remove redirect {redirect_id} against the unstable API.
        slots:
          redirect_id: path.redirect_id
      - text: Use the unstable endpoint to delete URL redirect {redirect_id}.
        slots:
          redirect_id: path.redirect_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/script_tags/{script_tag_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a script tag (2020-01)
      effect: destructive
      questions:
      - How do I remove a script tag my app injected into the storefront using 2020-01?
      - Can API version 2020-01 delete a script tag by ID?
      instructions:
      - text: Delete script tag {script_tag_id} using the 2020-01 API.
        slots:
          script_tag_id: path.script_tag_id
      - text: Stop loading storefront script {script_tag_id}, version 2020-01.
        slots:
          script_tag_id: path.script_tag_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/script_tags/{script_tag_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a script tag (2020-04)
      effect: destructive
      questions:
      - Can I pull a third-party script off my storefront with the 2020-04 release?
      - Which ID does version 2020-04 need to delete a script tag?
      instructions:
      - text: Remove script tag {script_tag_id} via 2020-04.
        slots:
          script_tag_id: path.script_tag_id
      - text: On 2020-04, pull script tag {script_tag_id} off the storefront.
        slots:
          script_tag_id: path.script_tag_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/script_tags/{script_tag_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a script tag (2020-07)
      effect: destructive
      questions:
      - Is there a 2020-07 endpoint to delete a script tag?
      - Can I clean up an app's leftover storefront JavaScript on version 2020-07?
      instructions:
      - text: Delete the script tag {script_tag_id} through API version 2020-07.
        slots:
          script_tag_id: path.script_tag_id
      - text: Clean up leftover script tag {script_tag_id} on 2020-07.
        slots:
          script_tag_id: path.script_tag_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/script_tags/{script_tag_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a script tag
      effect: destructive
      questions:
      - What call deletes a script tag in the 2020-10 Admin API?
      - Can I stop a script tag from loading on my theme with version 2020-10?
      instructions:
      - text: Delete script tag {script_tag_id} with the 2020-10 Admin API.
        slots:
          script_tag_id: path.script_tag_id
      - text: Using 2020-10, remove the storefront script tag {script_tag_id}.
        slots:
          script_tag_id: path.script_tag_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/script_tags/{script_tag_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a script tag (2021-01)
      effect: destructive
      questions:
      - Does the January 2021 (2021-01) API let me delete script tags?
      - Can I uninstall one script tag on 2021-01?
      instructions:
      - text: Uninstall script tag {script_tag_id} via the 2021-01 version.
        slots:
          script_tag_id: path.script_tag_id
      - text: With API version 2021-01, delete script tag {script_tag_id}.
        slots:
          script_tag_id: path.script_tag_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/script_tags/{script_tag_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a script tag (unstable)
      effect: destructive
      questions:
      - Can I delete a script tag through the unstable Admin API?
      - Is script tag removal supported on the unstable version?
      instructions:
      - text: Delete script tag {script_tag_id} against the unstable API.
        slots:
          script_tag_id: path.script_tag_id
      - text: Use the unstable endpoint to drop script tag {script_tag_id}.
        slots:
          script_tag_id: path.script_tag_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/themes/{theme_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a theme (2020-01)
      effect: destructive
      questions:
      - How do I delete an unused theme from my store with the 2020-01 API?
      - Can API version 2020-01 remove a theme by its ID?
      instructions:
      - text: Delete theme {theme_id} using the 2020-01 API.
        slots:
          theme_id: path.theme_id
      - text: Remove the unused store theme {theme_id} on version 2020-01.
        slots:
          theme_id: path.theme_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/themes/{theme_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a theme (2020-04)
      effect: destructive
      questions:
      - Can I clear out an old theme using release 2020-04?
      - Which ID does version 2020-04 need to delete a theme?
      instructions:
      - text: Clear out theme {theme_id} via 2020-04.
        slots:
          theme_id: path.theme_id
      - text: On 2020-04, permanently delete theme {theme_id}.
        slots:
          theme_id: path.theme_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/themes/{theme_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a theme (2020-07)
      effect: destructive
      questions:
      - Is there a 2020-07 endpoint to delete an online store theme?
      - Can I remove a draft theme with API version 2020-07?
      instructions:
      - text: Delete the theme {theme_id} through API version 2020-07.
        slots:
          theme_id: path.theme_id
      - text: Remove draft theme {theme_id} on 2020-07.
        slots:
          theme_id: path.theme_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/themes/{theme_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a theme
      effect: destructive
      questions:
      - What call deletes a theme in the 2020-10 Admin API?
      - Can I delete one of my store's themes by ID on version 2020-10?
      instructions:
      - text: Delete theme {theme_id} with the 2020-10 Admin API.
        slots:
          theme_id: path.theme_id
      - text: Using 2020-10, get rid of store theme {theme_id}.
        slots:
          theme_id: path.theme_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/themes/{theme_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a theme (2021-01)
      effect: destructive
      questions:
      - Does the January 2021 (2021-01) API let me delete a theme?
      - Can I tidy up leftover themes on 2021-01?
      instructions:
      - text: Tidy up by deleting theme {theme_id} via the 2021-01 version.
        slots:
          theme_id: path.theme_id
      - text: With API version 2021-01, remove theme {theme_id}.
        slots:
          theme_id: path.theme_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/themes/{theme_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a theme (unstable)
      effect: destructive
      questions:
      - Can I delete a theme through the unstable Admin API?
      - Is theme deletion supported on the unstable version?
      instructions:
      - text: Delete theme {theme_id} against the unstable API.
        slots:
          theme_id: path.theme_id
      - text: Use the unstable endpoint to discard theme {theme_id}.
        slots:
          theme_id: path.theme_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/orders/{order_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an order (2020-01)
      effect: destructive
      questions:
      - How do I permanently delete an order with the 2020-01 Admin API?
      - Can API version 2020-01 remove an order record by ID?
      instructions:
      - text: Delete order {order_id} using the 2020-01 API.
        slots:
          order_id: path.order_id
      - text: Permanently remove order record {order_id} on version 2020-01.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/orders/{order_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an order (2020-04)
      effect: destructive
      questions:
      - Can I erase a test order from my store with release 2020-04?
      - Which ID does version 2020-04 need to delete an order?
      instructions:
      - text: Erase test order {order_id} via 2020-04.
        slots:
          order_id: path.order_id
      - text: On 2020-04, delete the order {order_id}.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/products/{product_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product (2020-01)
      effect: destructive
      questions:
      - How do I delete a product from my catalog with the 2020-01 API?
      - Can API version 2020-01 remove a product by its ID?
      instructions:
      - text: Delete product {product_id} using the 2020-01 API.
        slots:
          product_id: path.product_id
      - text: Remove catalog product {product_id} on version 2020-01.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/products/{product_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product (2020-04)
      effect: destructive
      questions:
      - Can I take a discontinued product out of my store with release 2020-04?
      - Which ID does version 2020-04 need to delete a product?
      instructions:
      - text: Take discontinued product {product_id} out of the store via 2020-04.
        slots:
          product_id: path.product_id
      - text: On 2020-04, permanently delete product {product_id}.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/products/{product_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product (2020-07)
      effect: destructive
      questions:
      - Is there a 2020-07 endpoint to delete a product listing?
      - Can I remove a duplicate product with API version 2020-07?
      instructions:
      - text: Delete the product {product_id} through API version 2020-07.
        slots:
          product_id: path.product_id
      - text: Remove duplicate product {product_id} on 2020-07.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/products/{product_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product
      effect: destructive
      questions:
      - What call deletes a product in the 2020-10 Admin API?
      - Can I delete a product permanently by ID on version 2020-10?
      instructions:
      - text: Delete product {product_id} with the 2020-10 Admin API.
        slots:
          product_id: path.product_id
      - text: Using 2020-10, get rid of product listing {product_id}.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/products/{product_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product (2021-01)
      effect: destructive
      questions:
      - Does the January 2021 (2021-01) API let me delete a product?
      - Can I clean an old product out of my catalog on 2021-01?
      instructions:
      - text: Clean product {product_id} out of the catalog via the 2021-01 version.
        slots:
          product_id: path.product_id
      - text: With API version 2021-01, delete product {product_id}.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/products/{product_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product (unstable)
      effect: destructive
      questions:
      - Can I delete a product through the unstable Admin API?
      - Is product deletion supported on the unstable version?
      instructions:
      - text: Delete product {product_id} against the unstable API.
        slots:
          product_id: path.product_id
      - text: Use the unstable endpoint to discard product {product_id}.
        slots:
          product_id: path.product_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/orders/{order_id}/fulfillments/{fulfillment_id}/events/{event_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a fulfillment tracking event (2020-01)
      effect: destructive
      questions:
      - How do I delete a wrong tracking event from a shipment with the 2020-01 API?
      - Which three IDs does version 2020-01 need to remove a fulfillment event?
      instructions:
      - text: Delete event {event_id} from fulfillment {fulfillment_id} on order {order_id} using 2020-01.
        slots:
          order_id: path.order_id
          fulfillment_id: path.fulfillment_id
          event_id: path.event_id
      - text: On version 2020-01, remove tracking update {event_id} for shipment {fulfillment_id} of order {order_id}.
        slots:
          order_id: path.order_id
          fulfillment_id: path.fulfillment_id
          event_id: path.event_id
      method: generated
      generated: '2026-09-24'


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/shopify/refs/heads/main/overlays/shopify-deletes-api-phrasing-overlay.yaml