Record a failed delivery attempt
POST/v2/trips/:id/attempts
Paid API plans only. Records why a delivery didn't happen and what
happens next. The courier's last pinged position is saved with the
attempt; away_from_destination flags one logged far from the address.
next_action | The trip becomes |
|---|---|
retry | started (or pending if the courier never set off), for another try |
reschedule | pending, with reschedule_to as its new scheduled_arrival_at (within 14 days). The recipient's page shows the new time. |
return | returning. Give return_to for an ETA back to the sender; finish with PATCH status=returned |
stop | failed, and the trip closes |
Allowed on any open trip that isn't already returning, up to 10 per
trip. The recipient's page never shows the reason, note or calls.
Every attempt fires trip.attempt_failed.
Request
Responses
- 201
- 400
- 403
- 404
- 409
Recorded; the updated trip
Invalid reason, next action, time or call log (VALIDATION_ERROR)
Not on a paid API plan (PLAN_UPGRADE_REQUIRED)
No such trip on your account (TRIP_NOT_FOUND)
The trip is already closed (TRIP_CLOSED)