# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Doordash Stores API
  version: 1.0.0
extends: openapi/doordash-stores-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: 6
- target: $.paths['/businesses/{external_business_id}/stores'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a store under a business
      effect: write
      questions:
      - How do I add a new store location to a business?
      - What do I need to create a store, such as name and address?
      instructions:
      - text: Create store {external_store_id} named {name} at {address} for business {external_business_id}.
        slots:
          external_store_id: requestBody.external_store_id
          name: requestBody.name
          address: requestBody.address
          external_business_id: path.external_business_id
      - text: Add store {external_store_id} called {name} with phone {phone_number} at {address} to business {external_business_id}.
        slots:
          external_store_id: requestBody.external_store_id
          name: requestBody.name
          phone_number: requestBody.phone_number
          address: requestBody.address
          external_business_id: path.external_business_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/businesses/{external_business_id}/stores/{external_store_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a store under a business
      effect: read
      questions:
      - What are the details of a store under a business?
      - Can I look up a store by its business and store external ids?
      instructions:
      - text: Get store {external_store_id} in business {external_business_id}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
      - text: Show the address and phone of store {external_store_id} under business {external_business_id}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/businesses/{external_business_id}/stores/{external_store_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a store's name or address
      effect: write
      questions:
      - Can I change a store location's name or address?
      - How do I update the phone number of an existing store?
      instructions:
      - text: Update store {external_store_id} of business {external_business_id} with name {name} and address {address}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
          name: requestBody.name
          address: requestBody.address
      - text: Change the phone of store {external_store_id} in business {external_business_id} to {phone_number}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
          phone_number: requestBody.phone_number
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stores/{merchant_supplied_id}/store_details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get live store details by merchant ID
      effect: read
      questions:
      - What live store-level info does the integration show for my store?
      - Can I check a store's live settings by merchant supplied id?
      instructions:
      - text: Get live store details for merchant store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Show the live store-level info for {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stores/{merchant_supplied_id}/menu_details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get live menu details for a store
      effect: read
      questions:
      - What live menu info is set for a store on the integration?
      - Which menus are live for a store right now?
      instructions:
      - text: Fetch the live menu-level info for merchant store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Show which menus are live for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stores/{merchant_supplied_id}/status'].patch
  update:
    x-apievangelist-phrasing:
      intent: Open or close a store for orders
      effect: write
      questions:
      - How do I close my store for orders temporarily?
      - Can I record a reason when changing a store's status?
      instructions:
      - text: Set store {merchant_supplied_id} status to {status}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
          status: requestBody.status
      - text: Close store {merchant_supplied_id} for orders with reason {reason}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'