Start a new navigation session

After creating a new route and obtaining your route id, you can use the startNavigation mutation to start a new navigation session. A navigation session is automatically finished after 48 hours of inactivity. During that time frame you can subscribe to it for updates or query its current state.


To start a navigation session, you need a route id, an alternative_id and your current_location. Of these three arguments alternative_id is optional. In case no alternative was chosen explicitly the first route is used for the navigation session. In order to start a navigation session you need to be in proximity of the route.


  • input non_null NavigationStartInput

    Navigation start input

  • Response

    If successful, the HTTP status code in the response header is 200 and the response body contains the attributes you requested.

    If unsuccessful, the header status code is an error code and the response body contains an error response object. The error response object can be any of the ones below.

    Errors & warnings

    • Error

      No route alternative was found with the provided ID

    • Error

      No route was found with the provided ID