Assign vehicle
/journeys/{id}/assign-vehicleAuth: X-API-Key headerhttps://warpdrive.staging.transferz.com/transfercompanies
Assigns a vehicle to a journey driver
Assigns a vehicle to the journey's driver, so the traveller knows which car to look for. Assign the driver first. Send reassign true to replace an assigned vehicle.
Path parameters
Headers
Request body
application/json · required
Responses
No content
Errors this endpoint can return
- 400, failedDRIVER_NOT_ASSIGNED
When: No driver is assigned to the journey yet.
What to do: Assign a driver first with Assign to driver.
- 400, failedVEHICLE_ALREADY_ASSIGNED
When: A vehicle is assigned and reassign is false.
What to do: Send reassign true to replace it, or unassign the vehicle first.
- 400, failedUNKNOWN
When: The journey is completed or cancelled.
What to do: For 400, read
messageand correct the request. For 500, retry once; if it persists, contact Transferz support with the X-Request-ID you sent. - 403, failedINSUFFICIENT_PERMISSIONS
When: The journey is not assigned to your company (also returned for an unknown id).
What to do: Check that the id belongs to your company and that you use the key of the right user. Ask Transferz to check the account's permissions if the id is correct.