PATCH /moves/:id

Partially update an existing move. Only the fields included in the request body are modified — all other fields remain unchanged.

note

Moves can only be patched before pickup is completed and while uncanceled. Attempts to patch a move with a status of pickup successful, delivery started, delivery arrived, or delivery successful, or any canceled move, will return a 400 error.

Auth Header

curl --request PATCH \
  --url https://api.hopdrive.com/v1/moves/:id \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <your token>' \
  --data '{ ... }'

Example Request

PATCH /v1/moves/10033

{
  "vehicle_make": "Toyota",
  "vehicle_model": "Camry",
  "vehicle_year": "2022",
  "vehicle_color": "Blue",
  "ready_by": "2026-03-20T14:00:00+00:00"
}

Body Params

Field	Type	Required?	Description
vehicle_year	String	Optional	Model year of the vehicle.
vehicle_make	String	Optional	Make of the vehicle (e.g. Toyota).
vehicle_model	String	Optional	Model of the vehicle (e.g. Camry).
vehicle_color	String	Optional	Color of the vehicle.
vehicle_stock	String	Optional	Dealer stock number for the vehicle.
vehicle_vin	String	Optional	Vehicle Identification Number.
ready_by	String	Optional	ISO 8601 timestamp for when the vehicle will be ready for pickup.
reference_num	String	Optional	Your internal reference number for this move.

At least one field must be provided. Sending an empty body will return a 400 error.

Example Response

200 /v1/moves/10033

{
  "id": 10033,
  "vehicle_year": "2022",
  "vehicle_make": "Toyota",
  "vehicle_model": "Camry",
  "vehicle_color": "Blue",
  "vehicle_stock": "STK-00419",
  "vehicle_vin": "4T1BF1FK8CU512345",
  "ready_by": "2026-03-20T14:00:00+00:00",
  "reference_num": "REF-001"
}

Error Responses

Status	Description
400	Invalid move ID, empty body, invalid ready_by timestamp, unauthorized, or move is in a non-patchable state (post-pickup or canceled).
404	Move not found.
500	Unexpected server error.