API Evangelist conversational phrasing for Doordash Order Endpoints API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Doordash Order Endpoints API
  version: 1.0.0
extends: openapi/doordash-order-endpoints-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: 5
- target: $.paths['/api/v1/orders/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Confirm or fail an incoming order
      effect: write
      questions:
      - How does a merchant confirm or fail an incoming order?
      - Can I send a prep time when confirming an order?
      instructions:
      - text: Confirm order {id} with status {order_status}.
        slots:
          id: path.id
          order_status: requestBody.order_status
      - text: Confirm order {id} with a prep time of {prep_time}.
        slots:
          id: path.id
          prep_time: requestBody.prep_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orders/{id}/adjustment'].patch
  update:
    x-apievangelist-phrasing:
      intent: Cancel, adjust or substitute order items
      effect: write
      questions:
      - How do I substitute or remove items from an order?
      - Can a merchant change item quantities after an order comes in?
      instructions:
      - text: 'Adjust items on order {id}: {items}.'
        slots:
          id: path.id
          items: requestBody.items
      - text: Substitute or change quantities of {items} on order {id}.
        slots:
          items: requestBody.items
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orders/{id}/cancellation'].patch
  update:
    x-apievangelist-phrasing:
      intent: Cancel an entire order as the merchant
      effect: destructive
      questions:
      - How does a merchant cancel an entire order?
      - Can I give details explaining why a merchant cancelled an order?
      instructions:
      - text: Cancel order {id} because {cancel_reason}.
        slots:
          id: path.id
          cancel_reason: requestBody.cancel_reason
      - text: Cancel order {id} with reason {cancel_reason} and details {cancel_details}.
        slots:
          id: path.id
          cancel_reason: requestBody.cancel_reason
          cancel_details: requestBody.cancel_details
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orders/{id}/events/{event_type}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Send an order event such as ready for pickup
      effect: write
      questions:
      - How do I tell DoorDash an order is ready for pickup?
      - Which order events can a merchant send?
      instructions:
      - text: Send event {event_type} for order {id}.
        slots:
          event_type: path.event_type
          id: path.id
      - text: Tell the Dasher order {id} is ready by sending event {event_type}.
        slots:
          id: path.id
          event_type: path.event_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orders/{id}/return'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a retail order as returned
      effect: write
      questions:
      - How do I mark a retail order as returned?
      - Can restaurant orders be marked returned the same way as retail orders?
      instructions:
      - text: Mark retail order {id} returned with items {return_items} to location {return_location_id}.
        slots:
          id: path.id
          return_items: requestBody.return_items
          return_location_id: requestBody.return_location_id
      - text: Record a return of {return_items} on retail order {id}.
        slots:
          return_items: requestBody.return_items
          id: path.id
      method: generated
      generated: '2026-09-26'