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.
Guide: Assign driver and 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.