Skip to main content
PUT
Update odometer source (V2)

Overview

Switches the active odometer source between CAN (vehicle CAN bus) and GPS (GNSS-derived). Returns 409 if the device does not support the requested source.
Rate limit: 10 req/s · 30/min · 6,000/hr · 144,000/day

Endpoint

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

Path parameters

integer
required
Vehicle ID.

Query parameters

string
required
Desired odometer source. Must be CAN or GPS (case-insensitive).

Response

200 OK — empty body. Odometer source updated successfully.

Error responses

409 response body:

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /v2/api/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

source
enum<string>
required

Desired odometer source. Must be CAN or GPS (case-insensitive).

Available options:
CAN,
GPS

Response

200 OK — Empty body. Odometer source updated successfully.