# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Instacart Connect Fulfillment Last Mile Delivery API
  version: 1.0.0
extends: openapi/instacart-last-mile-delivery-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['/v2/fulfillment/stores/last_mile'].post
  update:
    x-apievangelist-phrasing:
      intent: Find stores offering last mile delivery
      effect: read
      questions:
      - Which stores can handle last mile delivery of pre-packed orders to an address?
      - Can I search for last mile stores by postal code?
      instructions:
      - text: Find last mile delivery stores for postal code {postal_code}.
        slots:
          postal_code: requestBody.postal_code
      - text: List stores offering last mile delivery near {latitude}, {longitude}.
        slots:
          latitude: requestBody.latitude
          longitude: requestBody.longitude
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/fulfillment/lastmile/users/{user_id}/service_options'].post
  update:
    x-apievangelist-phrasing:
      intent: Reserve a last mile delivery window
      effect: write
      questions:
      - How do I secure a delivery window for a pre-packed last mile order?
      - What time slots are available for last mile delivery from a store?
      instructions:
      - text: Reserve a last mile delivery slot for user {user_id} from store {store_id}.
        slots:
          user_id: path.user_id
          store_id: requestBody.store_id
      - text: Get and hold last mile time slots for user {user_id} delivering to {address}.
        slots:
          user_id: path.user_id
          address: requestBody.address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/fulfillment/lastmile/users/{user_id}/orders'].post
  update:
    x-apievangelist-phrasing:
      intent: Place a last mile delivery order
      effect: write
      questions:
      - How do I create an order for pre-packed items that only need transport to the customer?
      - Can I include driver instructions on a last mile order?
      instructions:
      - text: Create a last mile order for user {user_id} with hold {hold_id}.
        slots:
          user_id: path.user_id
          hold_id: requestBody.hold_id
      - text: Place a last mile delivery for user {user_id} on hold {hold_id} to {delivery_address}.
        slots:
          user_id: path.user_id
          hold_id: requestBody.hold_id
          delivery_address: requestBody.delivery_address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/fulfillment/lastmile/orders/{order_id}/staged'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a last mile order packed and ready
      effect: write
      questions:
      - How do I tell the driver a last mile order is packed and ready at the store?
      - When should a last mile order be marked as staged?
      instructions:
      - text: Mark last mile order {order_id} as staged for driver pickup.
        slots:
          order_id: path.order_id
      - text: Flag order {order_id} as packed and ready at the store.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'