Attach telematics device

post https://iris.trackunit.com/api/asset/v2beta1/assets/{assetId}/telematics-devices

This API request can be used to create a bluetooth telematics device and attach it to an existing asset.

Currently only one bluetooth telematics device can be attached to the asset.

⚠️
Beta Version
Please note that this version of the API is currently in beta and might change without warning until a stable V2 is released. This beta version supports the asset type "vehicle", for any other asset types we recommend using V1 for now.

Responses

Response body

object

assetType

string

required

Type	Description
Machine	Battery or fuel-powered heavy assets controlled by an operator.
Vehicle	Heavy assets used for transporting people or goods, especially on land.
Gateway	Serve as a communication managers between bluetooth tags and the Iris platform.
Attachment	Items added to machines or equipment for enhanced functionality.
Tool	Small powered assets like impact drills or high-pressure washers.
Equipment	Non-powered assets like wheelbarrows or containers.
Other	Assets that do not fit into the defined categories.

MACHINE VEHICLE GATEWAY OTHER ATTACHMENT EQUIPMENT TOOL

brand

string

The brand of the asset.

createdAt

date-time

required

Timestamp indicating when the asset was created on Iris platform.

externalReference

string

An external reference on the asset that can be used to store the identifier from other systems such as ERPs.

string

required

The ID of the asset.

model

string

The model of the asset.

name

string

required

The name of the asset.

ownerAccountId

string

required

The ID of the owner account.

productionDate

date

The production date of the asset.

productionYear

int32

≥ 1900

The year the asset was produced.

serialNumber

string

The asset serial number (e.g VIN).

telematicsDevices

array of objects

List of associated telematics devices.

telematicsDevices

object

deviceType

string

Device type, e.g. KIN, TU600, SPOT2.

string

required

ID of telematics device.

serialNumber

string

Serial number of the device.

type

string

The type of the asset (excavator, lift, bucket etc.)

Language

Credentials

Bearer

JWT


xxxxxxxxxx
13
1
curl --request POST \
2
     --url https://iris.trackunit.com/api/asset/v2beta1/assets/assetId/telematics-devices \
3
     --header 'accept: */*' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "telematicsDevices": [
8
    {
9
      "type": "KIN"
10
    }
11
  ]
12
}
13
'

Click Try It! to start a request and see the response here! Or choose an example:

*/*

application/json

⚠️Beta Version

200Telematics device was successfully attached.

400Bad request

401Invalid or missing bearer token in Authorization header

403User not allowed to make this request

404Resource not found

500Internal server error

⚠️
Beta Version