Skip to main content
PUT
/
api
/
v2
/
vehicles
/
{id}
/
odometer
Update odometer (V2)
curl --request PUT \
  --url https://api.telemax.com.au/api/v2/vehicles/{id}/odometer \
  --header 'Authorization: Bearer <token>'
{}

​
Overview

Updates the GPS odometer value for the specified vehicle.
The V1 version of this endpoint is Change odometer.
Rate limit: 30 requests per 60 seconds per token.

​
Endpoint

PUT /api/v2/vehicles/{id}/odometer

​
Path parameters

​
id
integer
required
Legacy vehicle ID.

​
Query parameters

​
odometer
number
required
New odometer value in kilometres.

​
Response

200 OK — empty body. The odometer was updated successfully.

​
Error responses

StatusMeaning
401Token does not have access to this vehicle
404Vehicle not found
422Invalid odometer value (e.g. negative number)
curl -X PUT "https://api.telemax.com.au/api/v2/vehicles/88421/odometer?odometer=154200" \
  -H "Authorization: Bearer <token>"

Authorizations

​
Authorization
string
header
required

JWT Bearer token obtained from POST /api/v2/authentication/token/api-key.

Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.

Scoping: API key tokens are scoped to the company the key belongs to and may restrict access to a vehicle allowlist and/or action set (see token claims).

No refresh endpoint — re-authenticate with your API key when the token expires.

Path Parameters

​
id
integer
required

Query Parameters

​
odometer
number

New odometer value in kilometres. Must be ≥ 0. Defaults to 0 if omitted.

Required range: x >= 0

Response

200 OK — Empty body. Odometer updated successfully.