Get desired state documentation

The states that are available for a given telematics device vary by device type, customer and firmware versions. This endpoint can be used to fetch the list of available states for a given telematics device.

It also includes preconditions and available parameters. Below is an example of how to configure the inputFiltering of a Trackunit telematics device:

{
    "io": {
        "inputFiltering": {
            "preconditions": {
                "minimumFirmwareVersion": 62.14
            },
            "parameters": [
                {
                    "name": "enabled",
                    "allowedValues": [
                        false,
                        true
                    ]
                }
            ]
        }
    }
}

The required minimum firmware version is 62.14. The configuration has only one property “enabled” that can be set to either “false” or “true”.

Enabling inputFiltering using the template will be to update the desired state with the following:

{
    "desired": {
        "io": {
            "inputFiltering": {
                "enabled": "true"
            }
        }
    }
}

See Update desired state for more information.

➡️

OpenAPI Specification for the Telematics Device API domain

Get the OpenAPI Specification (formerly Swagger), which is a standardized format that describes the functionalities, endpoints, parameters, and data models of this API in a JSON file here.

Language
Authorization
Bearer
JWT
Click Try It! to start a request and see the response here!