# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Doordash Deliveries API
  version: 1.0.0
extends: openapi/doordash-deliveries-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['/estimates'].post
  update:
    x-apievangelist-phrasing:
      intent: Estimate a delivery's fee and time
      effect: read
      questions:
      - How much will a delivery cost and how long will it take between two addresses?
      - Can I check whether an area is serviced before creating a delivery?
      instructions:
      - text: Estimate the fee and time to deliver from {pickup_address} to {dropoff_address}.
        slots:
          pickup_address: requestBody.pickup_address
          dropoff_address: requestBody.dropoff_address
      - text: Estimate delivering an order worth {order_value} from {pickup_address} to {dropoff_address}.
        slots:
          order_value: requestBody.order_value
          pickup_address: requestBody.pickup_address
          dropoff_address: requestBody.dropoff_address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deliveries'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a delivery and dispatch a Dasher
      effect: write
      questions:
      - How do I request a Dasher to deliver an order from my store to a customer?
      - Can I include a tip and dropoff instructions when creating a delivery?
      instructions:
      - text: Create delivery {external_delivery_id} from {pickup_address} to {dropoff_address}.
        slots:
          external_delivery_id: requestBody.external_delivery_id
          pickup_address: requestBody.pickup_address
          dropoff_address: requestBody.dropoff_address
      - text: Create delivery {external_delivery_id} from {pickup_address} to {dropoff_address} with a {tip} tip.
        slots:
          external_delivery_id: requestBody.external_delivery_id
          pickup_address: requestBody.pickup_address
          dropoff_address: requestBody.dropoff_address
          tip: requestBody.tip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deliveries/{external_delivery_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a delivery's status and details
      effect: read
      questions:
      - Where is my delivery right now and what is its status?
      - Can I look up a delivery by the external id I created it with?
      instructions:
      - text: Get the status of delivery {external_delivery_id}.
        slots:
          external_delivery_id: path.external_delivery_id
      - text: Track delivery {external_delivery_id}.
        slots:
          external_delivery_id: path.external_delivery_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deliveries/{external_delivery_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a delivery's tip or dropoff details
      effect: write
      questions:
      - Can I change the tip or dropoff instructions on a delivery in progress?
      - Are there limits on updating a delivery once it is underway?
      instructions:
      - text: Change the tip on delivery {external_delivery_id} to {tip}.
        slots:
          external_delivery_id: path.external_delivery_id
          tip: requestBody.tip
      - text: Update dropoff instructions for delivery {external_delivery_id} to {dropoff_instructions}.
        slots:
          external_delivery_id: path.external_delivery_id
          dropoff_instructions: requestBody.dropoff_instructions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/deliveries/{external_delivery_id}/cancel'].put
  update:
    x-apievangelist-phrasing:
      intent: Cancel an active delivery
      effect: destructive
      questions:
      - How do I cancel a delivery I no longer need?
      - Can a delivery still be cancelled after it has progressed?
      instructions:
      - text: Cancel delivery {external_delivery_id}.
        slots:
          external_delivery_id: path.external_delivery_id
      - text: Call off delivery {external_delivery_id} before it is picked up.
        slots:
          external_delivery_id: path.external_delivery_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/checkout_audit_signal'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a checkout audit signal
      effect: write
      questions:
      - What checkout events can I report for tracking a delivery's checkout flow?
      - Is there a way to send a checkout audit signal for a delivery?
      instructions:
      - text: Send a checkout audit signal of type {event_type} for delivery {external_delivery_id}.
        slots:
          event_type: requestBody.event_type
          external_delivery_id: requestBody.external_delivery_id
      - text: Record a checkout audit event for delivery {external_delivery_id}.
        slots:
          external_delivery_id: requestBody.external_delivery_id
      method: generated
      generated: '2026-09-26'