Skip to main content

Cancel Delivery

Parcel shipments can be canceled if they have not yet been handed off to DashLink. This includes shipments that were created in DashLink but never physically injected.

Endpoint​

PUT /drive/v2/deliveries/{external_delivery_id}/cancel

See the Drive API Reference for the full schema.

Behavior​

When cancellation succeeds:​

  • Delivery status becomes cancelled
  • cancellation_reason = "cancelled_by_creator"

When cancellation fails:​

  • Parcel may already have:
    • Been scanned at a facility
    • Been picked up by a dasher
    • Entered a terminal state

Important operational note:​

To prevent packages from being stranded, if you cancel an order but the package still arrives at a DashLink facility, DashLink will reactivate the order and schedule it for delivery.

When to use cancellation​

  • Customer requested cancellation before shipment left facility
  • Duplicate shipment detected
  • Tracking code incorrectly printed on label
  • Pre-labeling error (async flow)