Skip to main content

Update Vehicle

Update a Vehicle. If you need to update many Vehicles at once, use the Bulk API to avoid Rate Limiting errors.

Path Parameters

  • id string required

    The Fleetio ID of the relevant Vehicle.

    You may also look up Vehicles by their VIN, license plate, or other external ID. See the guide on External Vehicle Ids for information on how to set this up.

Request Body

  • color string

    Possible values: <= 255 characters

    The color of this Vehicle.

  • fuel_type_id integer

    The ID of the Fuel Type associated with this Vehicle.

  • fuel_volume_units VolumeUnit

    Possible values: [us_gallons, uk_gallons, liters]

  • group_id integer

    Possible values: >= 1

  • group_hierarchy string

    A pipe delimited group hierarchy. Ex: "Level 1|Level 2|Level 3". Where Level 1 is the parent of Level 2, and 2 is the parent of 3. Any missing nodes in the hierarchy will be created.

  • label_ids integer[]

    Possible values: >= 1

    The label_id(s) of any Labels to assign to this Vehicle. If you wish to keep any existing Labels, those IDs must be included in this array as well.

  • license_plate string

    Possible values: <= 255 characters

    The license plate number of this Vehicle.

  • make string

    Possible values: <= 255 characters

    The name of this Vehicle's manufacturer.

  • meter_unit MeterUnit

    Possible values: [km, hr, mi]

    The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

  • model string

    Possible values: <= 255 characters

    The name of the model of this Vehicle.

  • name string

    Possible values: <= 255 characters

    A name to assign to this Vehicle. Must be unique.

  • ownership VehicleOwnership

    Possible values: [owned, leased, rented, customer]

  • registration_expiration_month integer

    Possible values: <= 12

    The month in which this Vehicle's registration expires.

  • registration_state string

    Possible values: <= 255 characters

    The state, province, or territory in which this Vehicle is registered.

  • secondary_meter boolean

    Indicates whether or not this Vehicle has a secondary meter.

  • secondary_meter_unit MeterUnit

    Possible values: [km, hr, mi]

    The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

  • system_of_measurement MeasurementSystem

    Possible values: [imperial, metric]

  • trim string

    Possible values: <= 255 characters

    The trim level of this Vehicle.

  • vehicle_status_id integer

    Possible values: >= 1

  • vehicle_type_id integer

    Possible values: >= 1

  • vin string

    Possible values: <= 17 characters

    The Vehicle Identification Number of this Vehicle. Must be unique.

  • year integer

    This Vehicle's model year.

  • linked_vehicle_ids integer[]

    Possible values: >= 1

    The vehicle_id(s) of any Vehicles to link to this Vehicle.

  • purchase_detail_attributes object
  • comment string

    A comment about this Vehicle's purchase.

  • date date-time

    The date and time at which this Vehicle was purchased. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • price float

    The price of this Vehicle at the time of purchase.

  • vendor_id integer

    Possible values: >= 1

  • warranty_expiration_date date-time

    The date and time at which this Vehicle's warranty expires. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • warranty_expiration_meter_value float

    The meter value at which this Vehicle's warranty expires. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • meter_entry_attributes.value float

    The meter value at the time of purchase.

  • meter_entry_attributes.void boolean

    Indicates whether the Meter Entry created by passing meter_entry_attributes.value should be considered void. Voiding Meter Entries

  • external_ids object

    Any External IDs associated with this Vehicle.

  • vehicle_status_name string

    Possible values: <= 255 characters

    The name of the Vehicle Status associated with this Vehicle.

  • vehicle_type_name string

    Possible values: <= 255 characters

    The name of the Vehicle Type associated with this Vehicle.

  • in_service_date date-time

    The date on which this Vehicle was put into service. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • in_service_meter float

    The meter value at which this Vehicle was put into service.

  • estimated_service_months integer

    The estimated number of months this Vehicle will be in service.

  • estimated_replacement_mileage float

    The estimated number of miles before which this Vehicle will be replaced.

  • estimated_resale_price float

    The estimated resale price of this Vehicle.

  • out_of_service_date date-time

    The date on which this Vehicle was or will be retired. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • out_of_service_meter float

    The meter value at which this Vehicle was or will be retired.

  • specs_attributes object
  • base_towing_capacity float

    The base towing capacity of the Vehicle.

  • bed_length float

    The length of the Vehicle's bed.

  • body_subtype string

    The subtype of the Vehicle body.

  • body_type string

    The body type of the Vehicle.

  • brake_system string

    Possible values: <= 255 characters

    The brake system used in the Vehicle.

  • cargo_volume float

    Cargo volume of the Vehicle.

  • curb_weight float

    The curb weight of the Vehicle.

  • drive_type string

    Possible values: <= 255 characters

    The drive type of the Vehicle.

  • engine_aspiration string

    Possible values: <= 255 characters

    Aspiration type of the engine.

  • engine_block_type string

    Possible values: <= 255 characters

    Block type of the engine.

  • engine_bore float

    Bore size of the engine.

  • engine_brand string

    Possible values: <= 255 characters

    Brand of the Vehicle's engine.

  • engine_cam_type string

    Possible values: <= 255 characters

    Camshaft type of the engine.

  • engine_compression float

    Compression ratio of the engine.

  • engine_cylinders integer

    Number of engine cylinders.

  • engine_description string

    Description of the Vehicle's engine.

  • engine_displacement float

    The displacement of the Vehicle's engine.

  • engine_stroke float

    Stroke length of the engine.

  • engine_valves integer

    Number of engine valves.

  • epa_city float

    The EPA city fuel economy rating.

  • epa_combined float

    The combined EPA fuel economy rating.

  • epa_highway float

    The EPA highway fuel economy rating.

  • front_tire_psi float

    The recommended PSI for front tires.

  • front_tire_type string

    Possible values: <= 255 characters

    The type of front tires used in the Vehicle.

  • front_track_width float

    The front track width of the Vehicle.

  • front_wheel_diameter string

    Possible values: <= 255 characters

    The diameter of the front wheels.

  • fuel_induction string

    Possible values: <= 255 characters

    Fuel induction method.

  • fuel_quality string

    Possible values: <= 255 characters

    Fuel quality required for the engine.

  • fuel_tank_capacity float

    The fuel tank capacity of the Vehicle.

  • fuel_tank_2_capacity float

    The capacity of a second fuel tank, if applicable.

  • gross_vehicle_weight_rating float

    The Gross Vehicle Weight Rating (GVWR).

  • ground_clearance float

    The ground clearance of the Vehicle.

  • height float

    The height of the Vehicle.

  • interior_volume float

    Interior volume of the Vehicle.

  • length float

    The length of the Vehicle.

  • max_hp integer

    Maximum horsepower produced by the engine.

  • max_payload float

    The maximum payload capacity of the Vehicle.

  • max_torque integer

    Maximum torque produced by the engine.

  • msrp float

    Manufacturer's Suggested Retail Price (MSRP).

  • oil_capacity float

    Oil capacity of the engine.

  • passenger_volume string

    Possible values: <= 255 characters

    Passenger volume of the Vehicle.

  • rear_axle_type string

    Possible values: <= 255 characters

    The type of rear axle used in the Vehicle.

  • rear_tire_psi float

    The recommended PSI for rear tires.

  • rear_tire_type string

    Possible values: <= 255 characters

    The type of rear tires used in the Vehicle.

  • rear_track_width float

    The rear track width of the Vehicle.

  • rear_wheel_diameter string

    Possible values: <= 255 characters

    The diameter of the rear wheels.

  • redline_rpm string

    Possible values: <= 255 characters

    Redline RPM of the engine.

  • transmission_brand string

    Possible values: <= 255 characters

    Brand of the Vehicle's transmission.

  • transmission_description string

    Possible values: <= 255 characters

    Description of the Vehicle's transmission.

  • transmission_gears integer

    Number of gears in the transmission.

  • transmission_type string

    Possible values: <= 255 characters

    Type of transmission.

  • wheelbase float

    The wheelbase of the Vehicle.

  • width float

    The width of the Vehicle.

  • custom_fields object

    *Full details on working with Custom Fields here.

Responses

OK

Response Headers


    Schema

    • id integer
    • created_at date-time
    • updated_at date-time
    • account_id integer

      Possible values: >= 1

    • archived_at date-time

      The date and time at which the Vehicle was archived.

    • fuel_type_id NullableId

      Possible values: >= 1

    • fuel_type_name string

      The name of the Fuel Type associated with this Vehicle.

    • fuel_volume_units VolumeUnit

      Possible values: [us_gallons, uk_gallons, liters]

    • group_id NullableId

      Possible values: >= 1

    • group_name string

      The name of the Group associated with this Vehicle.

    • meter_unit MeterUnit

      Possible values: [km, hr, mi]

      The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

    • name string

      This Vehicle's name.

    • ownership VehicleOwnershipResponse

      Possible values: [Owned, Leased, Rented, Customer]

    • secondary_meter boolean

      Indicates whether or not this Vehicle has a secondary meter.

    • secondary_meter_unit MeterUnit

      Possible values: [km, hr, mi]

      The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.

    • system_of_measurement MeasurementSystem

      Possible values: [imperial, metric]

    • labels object[]

      The Labels associated with this Vehicle. Available by passing the expand=labels query parameter.

    • id integer

      Possible values: >= 1

    • name string

      The name of the Label. This is the value used to tag a record.

    • color string

      The hex color of the Label.

    • vehicle_status_id integer

      Possible values: >= 1

    • vehicle_status_name string

      The name of the Vehicle Status associated with this Vehicle.

    • vehicle_status_color string

      The color of the Vehicle Status associated with this Vehicle.

    • vehicle_type_id integer

      Possible values: >= 1

    • vehicle_type_name string

      The name of the Vehicle Type associated with this Vehicle.

    • fuel_entries_count integer

      The number of Fuel Entries associated with this Vehicle.

    • service_entries_count integer

      The number of Service Entries associated with this Vehicle.

    • service_reminders_count integer

      The number of Service Reminders associated with this Vehicle.

    • vehicle_renewal_reminders_count integer

      The number of Vehicle Renewal Reminders associated with this Vehicle.

    • comments_count integer

      The number of Comments associated with this Vehicle.

    • documents_count integer

      The number of documents attached to this Vehicle.

    • images_count integer

      The number of images attached to this Vehicle.

    • current_location_entry_id NullableId

      Possible values: >= 1

    • is_sample boolean

      Indicates whether this Vehicle record is Sample Data.

    • in_service_date date-time

      The date on which this Vehicle was put into service.

    • in_service_meter float

      The meter value at which this Vehicle was put into service.

    • estimated_service_months integer

      The estimated number of months this Vehicle will be in service.

    • estimated_replacement_mileage string

      The estimated number of miles before which this Vehicle will be replaced.

    • estimated_resale_price object

      The estimated resale price of this Vehicle.

    • cents integer

      The estimated resale price of this Vehicle in cents.

    • currency_iso string

      The ISO 4217 currency code of the estimated resale price.

    • out_of_service_date date-time

      The date on which this Vehicle was or will be retired.

    • out_of_service_meter float

      The meter value at which this Vehicle was or will be retired.

    • meter_name string

      The name of the primary meter for this Vehicle.

    • secondary_meter_name string

      The name of the secondary meter for this Vehicle.

    • primary_meter_usage_per_day string

      The average number of units of the primary meter used per day.

    • secondary_meter_usage_per_day string

      The average number of units of the secondary meter used per day.

    • current_meter_value float

      The current value of the primary meter for this Vehicle.

    • current_meter_date date-time

      The date and time at which the primary meter was last updated.

    • secondary_meter_value float

      The current value of the secondary meter for this Vehicle.

    • secondary_meter_date date-time

      The date and time at which the secondary meter was last updated.

    • group_ancestry string

      The ancestry of the Group associated with this Vehicle.

    • color string

      The color of this Vehicle.

    • license_plate string

      The license plate number of this Vehicle.

    • vin string

      The Vehicle Identification Number of this Vehicle.

    • year string

      This Vehicle's model year.

    • make string

      The name of this Vehicle's manufacturer.

    • model string

      The name of the model of this Vehicle.

    • trim string

      The trim level of this Vehicle.

    • registration_expiration_month integer

      Possible values: <= 12

      The month in which this Vehicle's registration expires.

    • registration_state string

      The state, province, or territory in which this Vehicle is registered.

    • loan_account_number string

      The account number for this Vehicle's loan, if applicable.

    • loan_ended_at date-time

      The date and time at which this Vehicle's loan ends.

    • loan_interest_rate float

      The interest rate for this Vehicle's loan.

    • loan_notes string

      Notes about this Vehicle's loan.

    • loan_started_at date-time

      The date and time at which this Vehicle's loan began. Formatted according to ISO-8601 in User's local time.

    • loan_vendor_id NullableId

      Possible values: >= 1

    • loan_vendor_name string

      The name of the Vendor for this Vehicle's loan.

    • custom_fields object

      *Full details on working with Custom Fields here.

    • inspection_schedules_count integer

      The number of inspection schedules this Vehicle is associated with.

    • issues_count integer

      The number of Issues this Vehicle is associated with.

    • work_orders_count integer

      The number of Work Orders this Vehicle is associated with.

    • type_name string

      The name of the Vehicle Type associated with this Vehicle.

    • default_image_url string

      The URL of the default image for this Vehicle.

    • default_image_url_medium string

      The URL of a medium-sized version of the default image for this Vehicle.

    • default_image_url_small string

      The URL of a small-sized version of the default image for this Vehicle.

    • default_image_url_large string

      The URL of a large-sized version of the default image for this Vehicle.

    • specs object
    • id integer

      Possible values: >= 1

    • vehicle_id integer

      The Vehicle ID these specs belong to.

    • account_id integer
    • body_type string

      The body type of the Vehicle, if available.

    • body_subtype string

      The subtype of the Vehicle body, if available.

    • drive_type string

      The drive type of the Vehicle, if available.

    • brake_system string

      The brake system used in the Vehicle, if available.

    • msrp_cents integer

      The Manufacturer's Suggested Retail Price (MSRP) in cents, if available.

    • fuel_tank_capacity float

      The fuel tank capacity of the Vehicle, if available.

    • fuel_tank_2_capacity float

      The capacity of a second fuel tank, if available.

    • front_track_width float

      The front track width of the Vehicle, if available.

    • ground_clearance float

      The ground clearance of the Vehicle, if available.

    • height float

      The height of the Vehicle, if available.

    • length float

      The length of the Vehicle, if available.

    • rear_track_width float

      The rear track width of the Vehicle, if available.

    • width float

      The width of the Vehicle, if available.

    • wheelbase float

      The wheelbase of the Vehicle, if available.

    • front_tire_psi string

      The recommended PSI for front tires, if available.

    • rear_tire_psi string

      The recommended PSI for rear tires, if available.

    • base_towing_capacity string

      The base towing capacity of the Vehicle, if available.

    • curb_weight float

      The curb weight of the Vehicle, if available.

    • gross_vehicle_weight_rating float

      The Gross Vehicle Weight Rating (GVWR), if available.

    • bed_length string

      The length of the Vehicle's bed, if available.

    • max_payload string

      The maximum payload capacity of the Vehicle, if available.

    • rear_axle_type string

      The type of rear axle used in the Vehicle.

    • front_tire_type string

      The type of front tires used in the Vehicle.

    • front_wheel_diameter string

      The diameter of the front wheels.

    • rear_tire_type string

      The type of rear tires used in the Vehicle.

    • rear_wheel_diameter string

      The diameter of the rear wheels.

    • epa_city float

      The EPA city fuel economy rating, if available.

    • epa_highway float

      The EPA highway fuel economy rating, if available.

    • epa_combined float

      The combined EPA fuel economy rating, if available.

    • engine_description string

      Description of the Vehicle's engine.

    • engine_brand string

      Brand of the Vehicle's engine.

    • engine_aspiration string

      Aspiration type of the engine, if available.

    • engine_block_type string

      Block type of the engine, if available.

    • engine_bore string

      Bore size of the engine, if available.

    • engine_cam_type string

      Camshaft type of the engine, if available.

    • engine_compression string

      Compression ratio of the engine, if available.

    • engine_cylinders integer

      Number of engine cylinders, if available.

    • engine_displacement string

      Engine displacement, if available.

    • fuel_induction string

      Fuel induction method, if available.

    • fuel_quality string

      Fuel quality required for the engine.

    • max_hp string

      Maximum horsepower produced by the engine, if available.

    • max_torque string

      Maximum torque produced by the engine, if available.

    • oil_capacity string

      Oil capacity of the engine, if available.

    • redline_rpm string

      Redline RPM of the engine.

    • engine_stroke string

      Stroke length of the engine, if available.

    • engine_valves integer

      Number of engine valves, if available.

    • transmission_description string

      Description of the Vehicle's transmission.

    • transmission_brand string

      Brand of the Vehicle's transmission.

    • transmission_type string

      Type of transmission, if available.

    • transmission_gears integer

      Number of gears in the transmission, if available.

    • cargo_volume float

      Cargo volume of the Vehicle, if available.

    • interior_volume float

      Interior volume of the Vehicle, if available.

    • passenger_volume string

      Passenger volume of the Vehicle.

    • created_at date-time

      The date and time when the specs were created.

    • updated_at date-time

      The date and time when the specs were last updated.

    • duty_type string

      Type of duty the Vehicle is designed for, if available.

    • weight_class string

      Weight class of the Vehicle, if available.

    • engine_bore_with_units string

      Bore size of the engine with units, if available.

    • wheelbase_with_units string

      Wheelbase of the Vehicle with units, if available.

    • msrp string

      Manufacturer's Suggested Retail Price (MSRP).

    • external_ids object

      Any External IDs associated with this Vehicle.

    • ai_enabled boolean

      Whether this Vehicle has Auto Integrate enabled for it.

    • assetable_type string

      Possible values: [Vehicle]

      Assetable type for Vehicle is always Vehicle for vehicles.

    • driver object
    • id NullableId

      Possible values: >= 1

    • first_name string

      The first name of the Contact (driver) associated with this Vehicle.

    • last_name string

      The last name of the Contact (driver) associated with this Vehicle.

    • full_name string

      The full name of the Contact (driver) associated with this Vehicle.

    • default_image_url string

      The URL of the default image of the Contact (driver) associated with this Vehicle.

    • current_location_entry object

      The current location of the associated object.

    • id integer

      The unique identifier for the current Location Entry.

    • locatable_type string

      The type of object that this Location Entry is associated with.

    • locatable_id integer

      The unique identifier of the object that this Location Entry is associated with.

    • date date-time

      The date and time when this Location Entry was recorded.

    • created_at date-time

      The date and time when this Location Entry was created.

    • updated_at date-time

      The date and time when this Location Entry was last updated.

    • contact_id integer

      The unique identifier of the associated Contact.

    • address string

      The address associated with this Location Entry.

    • is_current boolean

      Indicates whether this Location Entry is the current location.

    • item_type string

      The type of item associated with this Location Entry.

    • item_id integer

      The unique identifier of the item associated with this Location Entry.

    • location string

      The geographical location in the format "POINT (longitude latitude)".

    • address_components object
    • street_number string

      The street number in the address.

    • street string

      The street name in the address.

    • city string

      The city in the address.

    • region string

      The region, state or province in the address.

    • region_short string

      The abbreviated region, state or province code.

    • country string

      The country in the address.

    • country_short string

      The abbreviated country code.

    • postal_code string

      The postal code, ZIP, or equivalent in the address.

    • geolocation object
    • latitude float

      The latitude coordinate of the location.

    • longitude float

      The longitude coordinate of the location.

    • loan_amount float

      The amount of this Vehicle's loan.

    • loan_payment float

      The amount of this Vehicle's loan payment.

    • warranties_active_count integer

      The number of active warranties associated with this Vehicle.

    • warranties_count integer

      The number of warranties associated with this Vehicle.

    • residual_value float

      The residual value of this Vehicle at the end of its lease.

    • axle_config_id integer

      The id of the Axle Configuration of this vehicle.

    Loading...