Saves an unsaved vehicle of the organization the API key belongs to — 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 /v1/vehicle-api/vehicles/1093527491036451/save
{}POST /v1/vehicle-api/vehicles/1093527491036451/save
{ "owner": "Jane Doe", "licensePlate": "AB-123-CD", "color": "WHITE" }| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400vehicleId is not a positive integer, or the body is invalid: a licensePlate without 2 to 15 letters (of any alphabet) or digits, an owner over 100 characters, or an unknown make or color.
401Missing or invalid API key.
403Forbidden - Insufficient permissions to access this resource
404Unsaved vehicle not found in this organization.
429Too many requests. Try again later.
500Internal server error.
