Sign in

v1

latestOpenAPI 3.0.12026-07-243686491.1 MB
Vehicles

Transfer vehicle ownership

Required scope: vehicles:write. Transfers ownership of the vehicle to the given user, who must already be one of the vehicle's shared users.

post/api/v1/vehicles/{vehicleId}/users/{userId}/transfer-ownership

Path parameters

vehicleIdinteger required
userIdinteger required

Response

Vehicle with the new owner

idinteger

Id of the vehicle

teamIdinteger nullable

Team Id that the vehicle belongs to

userIdinteger nullable

User Id that the vehicle belongs to

namestring nullable

Name of the vehicle, can be customized by the user

licensePlatestring nullable

License plate of the vehicle

batteryCapacityKwhnumber double nullable

Battery capacity of the vehicle in Kwh

maxPowerKwAcnumber double nullable

Maximum AC charging power (in kW) that the vehicle can accept when charging via an AC charger

maxPowerKwDcnumber double nullable

Maximum DC charging power (in kW) that the vehicle can accept when using a DC fast charger

displayNamestring nullable

Display name of the vehicle

integrationIdinteger nullable

Id of the vehicle integration

integrationStatusstring nullable

Status of the vehicle integration

manuallyConfiguredAtstring date-time nullable

Timestamp when the vehicle was manually configured (null if using catalog model)

vidstring nullable

VID identifier for auto-charge

Example response

{
  "id": 1,
  "teamId": 2,
  "userId": 3,
  "name": "Tesla",
  "licensePlate": "CT88585",
  "batteryCapacityKwh": 85,
  "maxPowerKwAc": 29,
  "maxPowerKwDc": 35.5,
  "displayName": "Tesla Model 3 Performance (2021) - 72 kWh",
  "integrationId": 89188,
  "integrationStatus": "connected",
  "customSpecification": {
    "brand": "Volvo",
    "model": "FH Electric",
    "vehicleType": "truck"
  },
  "vid": "VID:001681036794"
}