Skip to main content
PUT
/
customer
/
{customerId}
/
vehicle
/
{vehicleId}
Update Vehicle
curl --request PUT \
  --url https://api.masternautconnect.com/connect-webservices/services/public/v1/customer/{customerId}/vehicle/{vehicleId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "name": "<string>",
  "registration": "<string>",
  "groupId": "<string>",
  "groupName": "<string>",
  "type": "<string>",
  "make": "<string>",
  "model": "<string>",
  "tags": [
    "<string>"
  ],
  "defaultDriverId": "<string>",
  "status": "<string>",
  "assetCosts": {
    "yearOfManufacture": 123,
    "ownershipStartDate": "2023-12-25",
    "ownershipEndDate": "2023-12-25",
    "purchaseCost": 123,
    "monthlyLeaseCost": 123,
    "monthlyInsuranceCost": 123,
    "monthlyMaintenanceCost": 123,
    "scheduledMaintenanceAmount": 123,
    "unscheduledMaintenanceAmount": 123,
    "costPerMileOverLimit": 123,
    "costOfDisposal": 123,
    "buyoutAmount": 123,
    "costCurrency": "<string>"
  }
}
'
{
  "id": "<string>",
  "name": "<string>",
  "registration": "<string>",
  "groupId": "<string>",
  "groupName": "<string>",
  "type": "<string>",
  "make": "<string>",
  "model": "<string>",
  "tags": [
    "<string>"
  ],
  "defaultDriverId": "<string>",
  "status": "<string>",
  "assetCosts": {
    "yearOfManufacture": 123,
    "ownershipStartDate": "2023-12-25",
    "ownershipEndDate": "2023-12-25",
    "purchaseCost": 123,
    "monthlyLeaseCost": 123,
    "monthlyInsuranceCost": 123,
    "monthlyMaintenanceCost": 123,
    "scheduledMaintenanceAmount": 123,
    "unscheduledMaintenanceAmount": 123,
    "costPerMileOverLimit": 123,
    "costOfDisposal": 123,
    "buyoutAmount": 123,
    "costCurrency": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
customerId
string
required
​
vehicleId
string
required

Body

application/json
​
id
string

Unique vehicle identifier

​
name
string

The friendly name for the vehicle.
If a value is specified then ● Cannot contain any one of these characters: <>?*"

​
registration
string

Vehicle registration number

​
groupId
string

Unique, unchangeable system generated identifier (alphanumeric) of an existing group to be assigned to this vehicle.

​
groupName
string

Group name

​
type
string

The vehicle type.
Can be one of the following: ● AMBULANCE ● BICYCLE ● BOAT ● BUS ● BUS_DOUBLE_DECK ● CAR ● CAR_ESTATE ● CAR_SPORTS ● CARAVAN ● CARRIAGE ● COACH ● CONTAINER_ASSET ● DIGGER ● DIGGER_2 ● GRITTER ● HGV ● HORSEBOX ● MAN ● MINIBUS ● MIXER ● MOTORCYCLE ● MOTORHOME ● PDA111 ● RIGID ● SMARTPHONE_PDA ● SWEEPER_LARGE ● SWEEPER_SMALL ● TIPPER ● TIPPER_2 ● TRACTOR ● TRACTOR_TRAILER ● TRAILER ● TRAIN ● VAN ● VAN_BOX ● VAN_SMALL ● WASTE_VEHICLE ● CHERRY_PICKER_HGV ● CHERRY_PICKER_LCV ● VAN_LCV ● POOL_CAR ● HEAVY_VAN_HGV ● TIPPER_MEDIUM

​
make
string

Vehicle make

​
model
string

Vehicle model

​
tags
string[]

Comma separated list of tags.
If specified

​
defaultDriverId
string

Default driver identifier

​
status
string

Status of the vehicle (optional).
Will remain as its current value on the asset if not present in the update document.
Can be one of the following: ● IN_CIRCULATION ● IN_MAINTENANCE ● SOLD

​
assetCosts
object

Costs associated with the vehicle.
● If specified replaces all existing asset costs.
● An empty assetCosts document will remove all costs.

Response

updated asset with correct values

​
id
string

Unique vehicle identifier

​
name
string

The friendly name for the vehicle.
If a value is specified then ● Cannot contain any one of these characters: <>?*"

​
registration
string

Vehicle registration number

​
groupId
string

Unique, unchangeable system generated identifier (alphanumeric) of an existing group to be assigned to this vehicle.

​
groupName
string

Group name

​
type
string

The vehicle type.
Can be one of the following: ● AMBULANCE ● BICYCLE ● BOAT ● BUS ● BUS_DOUBLE_DECK ● CAR ● CAR_ESTATE ● CAR_SPORTS ● CARAVAN ● CARRIAGE ● COACH ● CONTAINER_ASSET ● DIGGER ● DIGGER_2 ● GRITTER ● HGV ● HORSEBOX ● MAN ● MINIBUS ● MIXER ● MOTORCYCLE ● MOTORHOME ● PDA111 ● RIGID ● SMARTPHONE_PDA ● SWEEPER_LARGE ● SWEEPER_SMALL ● TIPPER ● TIPPER_2 ● TRACTOR ● TRACTOR_TRAILER ● TRAILER ● TRAIN ● VAN ● VAN_BOX ● VAN_SMALL ● WASTE_VEHICLE ● CHERRY_PICKER_HGV ● CHERRY_PICKER_LCV ● VAN_LCV ● POOL_CAR ● HEAVY_VAN_HGV ● TIPPER_MEDIUM

​
make
string

Vehicle make

​
model
string

Vehicle model

​
tags
string[]

Comma separated list of tags.
If specified

​
defaultDriverId
string

Default driver identifier

​
status
string

Status of the vehicle (optional).
Will remain as its current value on the asset if not present in the update document.
Can be one of the following: ● IN_CIRCULATION ● IN_MAINTENANCE ● SOLD

​
assetCosts
object

Costs associated with the vehicle.
● If specified replaces all existing asset costs.
● An empty assetCosts document will remove all costs.