LemursEye
Documentation
API

Update a vehicle

PUThttps://lemurseye.com/api/v1/vehicles/{id}

Replaces the vehicle's details. Send every field you want to keep: a field left out is cleared, except plate, which stays as it was.

Read the vehicle first with Retrieve a vehicle, change what you need, and send it back.

Permission: fleet:write. The token is sent as Authorization: Bearer <token>; see Authentication.

Path parameters

  • iduuidrequired

    The vehicle's id.

Body (JSON)

  • platestring

    Licence plate. Left out, it stays as it was.

  • namestring

    What your team calls it.

  • makestring

    Manufacturer.

  • modelstring

    Model.

  • modelYearinteger

    Model year.

  • categorystring

    One of sedan, suv, pickup, van, minibus, truck, bus, motorcycle.

  • defaultDriverIduuid

    An active driver's id.

Response

200

The updated vehicle.

Response fields

  • iduuid

    The vehicle's id.

  • platestring

    Licence plate, unique in your company.

  • namestring | null

    What your team calls it, e.g. Van 7.

  • makestring | null

    Manufacturer.

  • modelstring | null

    Model.

  • modelYearinteger | null

    Model year.

  • categorystring | null

    One of sedan, suv, pickup, van, minibus, truck, bus, motorcycle. Sets the fuel consumption defaults.

  • defaultDriverIduuid | null

    The vehicle's usual driver: trips are credited to them unless a driver signs in on the app.

  • createdAttimestamp

    When it was added (ISO 8601, UTC).

Errors

Where a message is listed, it comes back as JSON: { "error": "..." }. Otherwise only the status code is returned.

  • 404
    vehicle not found

    No vehicle with this id.

  • 409
    a vehicle with this plate already exists

    Another vehicle has the new plate.

  • 400
    driver not found

    defaultDriverId is not a driver in your company.

  • 400
    driver is inactive

    defaultDriverId is a deactivated driver.

  • 401

    No token, or it has expired.

  • 403

    The token lacks the permission above.

← Retrieve a vehicleDelete a vehicle →