API Evangelist conversational phrasing for Storefront V1 API Specification Order API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Storefront V1 API Specification Order API
  version: 1.0.0
extends: openapi/doordash-order-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: 4
- target: $.paths['/storefront/api/v1/orders/order_session'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an order session from an external cart
      effect: write
      questions:
      - How do I create an order session from an external cart?
      - Can I schedule an order session for a later time?
      instructions:
      - text: Create an order session at store {store_id} from menu {menu_id} for {fulfillment_type} with {items}.
        slots:
          store_id: requestBody.store_id
          menu_id: requestBody.menu_id
          fulfillment_type: requestBody.fulfillment_type
          items: requestBody.items
      - text: Create a {fulfillment_type} order session at store {store_id} from menu {menu_id} scheduled for {scheduled_time} with {items}.
        slots:
          fulfillment_type: requestBody.fulfillment_type
          store_id: requestBody.store_id
          menu_id: requestBody.menu_id
          scheduled_time: requestBody.scheduled_time
          items: requestBody.items
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/orders/order_session_to_cart'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn an order session into a cart
      effect: write
      questions:
      - What's the way to turn an order session into a cart for a consumer?
      - Can I clear a consumer's existing carts when converting an order session?
      instructions:
      - text: Create a cart from order session {order_session_id} for consumer {consumer_id}.
        slots:
          order_session_id: requestBody.order_session_id
          consumer_id: requestBody.consumer_id
      - text: Convert order session {order_session_id} into a cart for consumer {consumer_id} and delete their existing carts.
        slots:
          order_session_id: requestBody.order_session_id
          consumer_id: requestBody.consumer_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/orders/order_history'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a consumer's order history
      effect: read
      questions:
      - What orders has a consumer placed before?
      - Can I show a signed-in consumer their past orders?
      instructions:
      - text: Get order history for session {session_id}.
        slots:
          session_id: requestBody.session_id
      - text: List past orders for the consumer in session {session_id}.
        slots:
          session_id: requestBody.session_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/orders/order_status'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the status of a storefront order
      effect: read
      questions:
      - What's the status of a storefront order?
      - Has a storefront order been delivered yet?
      instructions:
      - text: Get the status of order {order_id}.
        slots:
          order_id: requestBody.order_id
      - text: Check where storefront order {order_id} stands.
        slots:
          order_id: requestBody.order_id
      method: generated
      generated: '2026-09-26'