Saves an unsaved vehicle of the application's organization — a license plate cameras read with high confidence in the last 7 days — and returns it.

Input. vehicleId in the path, the id of an unsaved vehicle from List vehicles (saved=false). The JSON body is optional. owner is up to 100 characters. make and color default to the make and color the cameras detected; pass a value to override it or null for none. licensePlate saves the vehicle under a corrected license plate instead of the detected one.

Response. 200 with the saved vehicle. Without licensePlate it keeps its vehicleId; with a different license plate it gets the id of that license plate.

Notes. A vehicle that is already saved answers 409 with code: VEHICLE_ALREADY_SAVED. A licensePlate that is already saved answers 409 with code: VEHICLE_EXISTS and details.vehicleId. An id that is not an unsaved vehicle of the last 7 days answers 404.

Side effects. The vehicle becomes a saved vehicle of the organization. Undo with Delete a vehicle.

Request examples

POST /v3/vehicle-api/vehicles/1093527491036451/save

{}

POST /v3/vehicle-api/vehicles/1093527491036451/save

{ "owner": "Jane Doe", "licensePlate": "AB-123-CD", "color": "WHITE" }

Required scope: write:vehicles