Assign driver to route

A PUT request to the /routes/{routeUuid}/driver endpoint assigns the specified driver to a specific route within Routific.

Request URL

put https://api.plan.routific.com/v2/routes/{routeUuid}/driver

📘
How do I know my route's uuid?
You can get your route uuids by calling the Fetch routes endpoint.

Request Payload

{"driverUuid": "b36f95d6-e9f4-401c-b91d-1cb901ad57c1"}

📘
How do I know my driver's uuid?
You can get your driver's uuid by calling the Fetch drivers endpoint.

📘
Route status for assigning a driver
Only routes with either planned or published status can be assigned a driver

Sample Response Payload

Below is a sample response payload illustrating the successful driver assignment request.

{
    "uuid": "042ebafe-a19e-42cb-ae64-2152306305dc",
    "workspaceUuid": "e2e2ef34-59f4-4f3b-9a11-c523c69bb5c1",
    "name": "route",
    "constraints": {
        "startTime": "09:00",
        "endTime": "17:00",
        "capacity": null,
        "tags": []
    },
    "driver": {
        "name": "John Doe",
        "uuid": "3255bb9d-fd3b-4e33-bc7e-0dda60bae3b4"
    },
    "timeline": {
        "uri": "/v2/routes/042ebafe-a19e-42cb-ae64-2152306305dc/timeline"
    },
    "date": "2026-10-15",
    "status": "planned",
    "workingTimeInSeconds": 0,
    "distanceInKilometers": 0,
    "ordersCount": 0,
    "capacityUsed": 0
}

Here's a description of the fields returned in the response payload:

Field	Type	Description
uuid	String	Unique identifier of the route.
workspaceUuid	String	Unique identifier of the workspace that the route belongs to.
name	String	The name of the route.
constraints.startTime	String	The configured start time of the route.
constraints.endTime	String	The configured end time of the route.
constraints.capacity	Integer	The maximum capacity of the route.
constraints.tags	Array	Tags assigned to the routes
driver.name	String	Name of the driver.
driver.uuid	String	Unique identifier of the driver.
timeline.uri	String	The URI to access additional details about a route's timeline like the sequence of stops and their associated ETAs.
date	String	The date that the routes is scheduled to be executed on.
status	String	Current status of the route. Possible values: planned, published, executing, and completed.
workingTimeInSeconds	Integer	Total working time for the route in seconds.
distanceInKilometers	Integer	Total distance covered by the route in kilometers.
ordersCount	Integer	Number of orders assigned to the route.
capacityUsed	Integer	Total utilized capacity of the routes based on the orders assigned to the route.