# 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 Promotions API
  version: 1.0.0
extends: openapi/doordash-promotions-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: 2
- target: $.paths['/promotions/stores/{store_location_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Add item promotions at a store
      effect: write
      questions:
      - Where do I set promotional prices for items at a store?
      - Can I run an item-level promotion at one store location?
      instructions:
      - text: Add item promotions {promotions} at store {store_location_id}.
        slots:
          promotions: requestBody.promotions
          store_location_id: path.store_location_id
      - text: Set promotional pricing for items at store {store_location_id} using {promotions}.
        slots:
          store_location_id: path.store_location_id
          promotions: requestBody.promotions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/promotions/stores/{store_location_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update item promotions at a store
      effect: write
      questions:
      - Can I change item promotions already running at a store?
      - How do I edit the promotional price of an item at a store?
      instructions:
      - text: Update existing item promotions {promotions} at store {store_location_id}.
        slots:
          promotions: requestBody.promotions
          store_location_id: path.store_location_id
      - text: Change the running item promotions at store {store_location_id} to {promotions}.
        slots:
          store_location_id: path.store_location_id
          promotions: requestBody.promotions
      method: generated
      generated: '2026-09-26'