API Evangelist conversational phrasing for Doordash Item management API Specification Inventory…

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Doordash Item management API Specification Inventory…
  version: 1.0.0
extends: openapi/doordash-inventorymanagementendpoints-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/api/v2/stores/{store_location_id}/items'].post
  update:
    x-apievangelist-phrasing:
      intent: Put a new item on sale at a store
      effect: write
      questions:
      - How do I make a new item available for sale at a store with a base price?
      - Is a base price and status required when adding an item to a store?
      instructions:
      - text: Add item {items} for sale at store {store_location_id}.
        slots:
          items: requestBody.items
          store_location_id: path.store_location_id
      - text: Start selling new items {items} at store {store_location_id} with base price and status.
        slots:
          items: requestBody.items
          store_location_id: path.store_location_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/stores/{store_location_id}/items'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an item a store already sells
      effect: write
      questions:
      - What's the way to update price or stock of an item a store already sells?
      - Can I update items with extras or options through the store item update?
      instructions:
      - text: Update in-store price and status for {items} at store {store_location_id}.
        slots:
          items: requestBody.items
          store_location_id: path.store_location_id
      - text: Mark {items} out of stock at store {store_location_id}.
        slots:
          items: requestBody.items
          store_location_id: path.store_location_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/businesses/{business_id}/items'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update item prices across all business stores
      effect: write
      questions:
      - Can I update an item's price across every store in a business at once?
      - Which fields can I change when updating items business-wide?
      instructions:
      - text: Update prices of {items} across all stores of business {business_id}.
        slots:
          items: requestBody.items
          business_id: path.business_id
      - text: Change the base price of {items} for every store in business {business_id}.
        slots:
          items: requestBody.items
          business_id: path.business_id
      method: generated
      generated: '2026-09-26'