samsara-api 0.0.1__py3-none-any.whl

samsara/vehicles/client.py

@@ -0,0 +1,693 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.attribute_tiny import AttributeTiny
+from ..types.gross_vehicle_weight import GrossVehicleWeight
+from ..types.user_identifier_serial import UserIdentifierSerial
+from ..types.vehicle_regulation_mode import VehicleRegulationMode
+from ..types.vehicle_response import VehicleResponse
+from ..types.vehicle_type import VehicleType
+from ..types.vehicles_list_vehicles_response_body import VehiclesListVehiclesResponseBody
+from .immobilizer.client import AsyncImmobilizerClient, ImmobilizerClient
+from .locations.client import AsyncLocationsClient, LocationsClient
+from .raw_client import AsyncRawVehiclesClient, RawVehiclesClient
+from .stats.client import AsyncStatsClient, StatsClient
+from .tachograph_files.client import AsyncTachographFilesClient, TachographFilesClient
+from .types.update_vehicle_request_aux_input_type_1 import UpdateVehicleRequestAuxInputType1
+from .types.update_vehicle_request_aux_input_type_2 import UpdateVehicleRequestAuxInputType2
+from .types.update_vehicle_request_aux_input_type_3 import UpdateVehicleRequestAuxInputType3
+from .types.update_vehicle_request_aux_input_type_4 import UpdateVehicleRequestAuxInputType4
+from .types.update_vehicle_request_aux_input_type_5 import UpdateVehicleRequestAuxInputType5
+from .types.update_vehicle_request_aux_input_type_6 import UpdateVehicleRequestAuxInputType6
+from .types.update_vehicle_request_aux_input_type_7 import UpdateVehicleRequestAuxInputType7
+from .types.update_vehicle_request_aux_input_type_8 import UpdateVehicleRequestAuxInputType8
+from .types.update_vehicle_request_aux_input_type_9 import UpdateVehicleRequestAuxInputType9
+from .types.update_vehicle_request_aux_input_type_10 import UpdateVehicleRequestAuxInputType10
+from .types.update_vehicle_request_aux_input_type_11 import UpdateVehicleRequestAuxInputType11
+from .types.update_vehicle_request_aux_input_type_12 import UpdateVehicleRequestAuxInputType12
+from .types.update_vehicle_request_aux_input_type_13 import UpdateVehicleRequestAuxInputType13
+from .types.update_vehicle_request_harsh_acceleration_setting_type import (
+    UpdateVehicleRequestHarshAccelerationSettingType,
+)
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class VehiclesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawVehiclesClient(client_wrapper=client_wrapper)
+        self.immobilizer = ImmobilizerClient(client_wrapper=client_wrapper)
+
+        self.locations = LocationsClient(client_wrapper=client_wrapper)
+
+        self.stats = StatsClient(client_wrapper=client_wrapper)
+
+        self.tachograph_files = TachographFilesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawVehiclesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawVehiclesClient
+        """
+        return self._raw_client
+
+    def list(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        after: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        attribute_value_ids: typing.Optional[str] = None,
+        updated_after_time: typing.Optional[str] = None,
+        created_after_time: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> VehiclesListVehiclesResponseBody:
+        """
+        Returns a list of all vehicles.
+
+         <b>Rate limit:</b> 25 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+
+        To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        after : typing.Optional[str]
+             If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        attribute_value_ids : typing.Optional[str]
+            A filter on the data based on this comma-separated list of attribute value IDs. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributeValueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544`
+
+        updated_after_time : typing.Optional[str]
+             A filter on data to have an updated at time after or equal to this specified time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        created_after_time : typing.Optional[str]
+             A filter on data to have a created at time after or equal to this specified time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        VehiclesListVehiclesResponseBody
+            OK response.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.vehicles.list()
+        """
+        _response = self._raw_client.list(
+            limit=limit,
+            after=after,
+            parent_tag_ids=parent_tag_ids,
+            tag_ids=tag_ids,
+            attribute_value_ids=attribute_value_ids,
+            updated_after_time=updated_after_time,
+            created_after_time=created_after_time,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def get(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> VehicleResponse:
+        """
+        Get information about a specific vehicle.
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+        Parameters
+        ----------
+        id : str
+            ID of the vehicle. This can either be the Samsara-specified ID, or an external ID. External IDs are customer specified key-value pairs created in the POST or PATCH requests of this resource, or automatically populated by fields on the vehicle. To specify an external ID as part of a path parameter, use the following format: `key:value`. For example, `maintenanceId:250020`. Automatically populated external IDs are prefixed with `samsara.`. For example, `samsara.vin:1HGBH41JXMN109186`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        VehicleResponse
+            Returns the specified vehicle object.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.vehicles.get(
+            id="id",
+        )
+        """
+        _response = self._raw_client.get(id, request_options=request_options)
+        return _response.data
+
+    def update(
+        self,
+        id: str,
+        *,
+        attributes: typing.Optional[typing.Sequence[AttributeTiny]] = OMIT,
+        aux_input_type_1: typing.Optional[UpdateVehicleRequestAuxInputType1] = OMIT,
+        aux_input_type_10: typing.Optional[UpdateVehicleRequestAuxInputType10] = OMIT,
+        aux_input_type_11: typing.Optional[UpdateVehicleRequestAuxInputType11] = OMIT,
+        aux_input_type_12: typing.Optional[UpdateVehicleRequestAuxInputType12] = OMIT,
+        aux_input_type_13: typing.Optional[UpdateVehicleRequestAuxInputType13] = OMIT,
+        aux_input_type_2: typing.Optional[UpdateVehicleRequestAuxInputType2] = OMIT,
+        aux_input_type_3: typing.Optional[UpdateVehicleRequestAuxInputType3] = OMIT,
+        aux_input_type_4: typing.Optional[UpdateVehicleRequestAuxInputType4] = OMIT,
+        aux_input_type_5: typing.Optional[UpdateVehicleRequestAuxInputType5] = OMIT,
+        aux_input_type_6: typing.Optional[UpdateVehicleRequestAuxInputType6] = OMIT,
+        aux_input_type_7: typing.Optional[UpdateVehicleRequestAuxInputType7] = OMIT,
+        aux_input_type_8: typing.Optional[UpdateVehicleRequestAuxInputType8] = OMIT,
+        aux_input_type_9: typing.Optional[UpdateVehicleRequestAuxInputType9] = OMIT,
+        engine_hours: typing.Optional[int] = OMIT,
+        external_ids: typing.Optional[typing.Dict[str, str]] = OMIT,
+        gateway_serial: typing.Optional[UserIdentifierSerial] = OMIT,
+        gross_vehicle_weight: typing.Optional[GrossVehicleWeight] = OMIT,
+        harsh_acceleration_setting_type: typing.Optional[UpdateVehicleRequestHarshAccelerationSettingType] = OMIT,
+        license_plate: typing.Optional[str] = OMIT,
+        name: typing.Optional[str] = OMIT,
+        notes: typing.Optional[str] = OMIT,
+        odometer_meters: typing.Optional[int] = OMIT,
+        static_assigned_driver_id: typing.Optional[str] = OMIT,
+        tag_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        vehicle_regulation_mode: typing.Optional[VehicleRegulationMode] = OMIT,
+        vehicle_type: typing.Optional[VehicleType] = OMIT,
+        vin: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> VehicleResponse:
+        """
+        Updates the given Vehicle object.
+
+        **Note:** Vehicle objects are automatically created when Samsara Vehicle Gateways are installed. You cannot create a Vehicle object via API.
+
+        You are able to *update* many of the fields of a Vehicle.
+
+        **Note**: There are no required fields in the request body, and you only need to provide the fields you wish to update.
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        To use this endpoint, select **Write Vehicles** under the Vehicles category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+        Parameters
+        ----------
+        id : str
+            ID of the vehicle. This can either be the Samsara-specified ID, or an external ID. External IDs are customer specified key-value pairs created in the POST or PATCH requests of this resource, or automatically populated by fields on the vehicle. To specify an external ID as part of a path parameter, use the following format: `key:value`. For example, `maintenanceId:250020`. Automatically populated external IDs are prefixed with `samsara.`. For example, `samsara.vin:1HGBH41JXMN109186`.
+
+        attributes : typing.Optional[typing.Sequence[AttributeTiny]]
+
+        aux_input_type_1 : typing.Optional[UpdateVehicleRequestAuxInputType1]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_10 : typing.Optional[UpdateVehicleRequestAuxInputType10]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_11 : typing.Optional[UpdateVehicleRequestAuxInputType11]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_12 : typing.Optional[UpdateVehicleRequestAuxInputType12]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_13 : typing.Optional[UpdateVehicleRequestAuxInputType13]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_2 : typing.Optional[UpdateVehicleRequestAuxInputType2]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_3 : typing.Optional[UpdateVehicleRequestAuxInputType3]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_4 : typing.Optional[UpdateVehicleRequestAuxInputType4]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_5 : typing.Optional[UpdateVehicleRequestAuxInputType5]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_6 : typing.Optional[UpdateVehicleRequestAuxInputType6]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_7 : typing.Optional[UpdateVehicleRequestAuxInputType7]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_8 : typing.Optional[UpdateVehicleRequestAuxInputType8]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_9 : typing.Optional[UpdateVehicleRequestAuxInputType9]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        engine_hours : typing.Optional[int]
+            A manual override for the vehicle's engine hours. You may only override a vehicle's engine hours if it cannot be read from on-board diagnostics. When you provide a manual engine hours override, Samsara will begin updating a vehicle's engine hours based on when the Samsara Vehicle Gateway is recieving power or not. Setting the value to 0 will unset the manual engine hours.
+
+        external_ids : typing.Optional[typing.Dict[str, str]]
+            The <a href="/docs/external-ids" target="_blank">external IDs</a> for the given object.
+
+        gateway_serial : typing.Optional[UserIdentifierSerial]
+
+        gross_vehicle_weight : typing.Optional[GrossVehicleWeight]
+
+        harsh_acceleration_setting_type : typing.Optional[UpdateVehicleRequestHarshAccelerationSettingType]
+            The harsh acceleration setting type. This setting influences the acceleration sensitivity from which a <a href="https://kb.samsara.com/hc/en-us/articles/360043051792-Safety-Event-Overview" target="_blank">harsh event</a> is triggered. **By default**, this setting is inferred by the Samsara Vehicle Gateway from the engine computer, but it may be set or updated through the Samsara Dashboard or the API at any time. If set to `off`, then no acceleration based harsh events are triggered for the vehicle. Valid values: `passengerCar`, `lightTruck`, `heavyDuty`, `off`, `automatic`.
+
+        license_plate : typing.Optional[str]
+            The license plate of the Vehicle. **By default**: empty. Can be set or updated through the Samsara Dashboard or the API at any time.
+
+        name : typing.Optional[str]
+            The human-readable name of the Vehicle. This is set by a fleet administrator and will appear in both Samsara’s cloud dashboard as well as the Samsara Driver mobile app. **By default**, this name is the serial number of the Samsara Vehicle Gateway. It can be set or updated through the Samsara Dashboard or through the API at any time.
+
+        notes : typing.Optional[str]
+            These are generic notes about the Vehicle. Empty by default. Can be set or updated through the Samsara Dashboard or the API at any time.
+
+        odometer_meters : typing.Optional[int]
+            A manual override for the vehicle's odometer. You may only override a vehicle's odometer if it cannot be read from on-board diagnostics. When you provide a manual odometer override, Samsara will begin updating a vehicle's odometer using GPS distance traveled since this override was set. See <a href="https://kb.samsara.com/hc/en-us/articles/115005273667" target="_blank">here</a> for more details.
+
+        static_assigned_driver_id : typing.Optional[str]
+            ID for the static assigned driver of the vehicle. Setting the value to 0 will unassign the current driver.
+
+        tag_ids : typing.Optional[typing.Sequence[str]]
+            An array of IDs of tags to associate with this vehicle. If your access to the API is scoped by one or more tags, this field is required to pass in.
+
+        vehicle_regulation_mode : typing.Optional[VehicleRegulationMode]
+
+        vehicle_type : typing.Optional[VehicleType]
+
+        vin : typing.Optional[str]
+            The VIN of the Vehicle. Most of the time, this will be automatically read from the engine computer by the Samsara Vehicle Gateway. It will be empty if it cannot be read. It can be set or updated through the Samsara Dashboard or the API at any time.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        VehicleResponse
+            Returns the specified vehicle object.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.vehicles.update(
+            id="id",
+        )
+        """
+        _response = self._raw_client.update(
+            id,
+            attributes=attributes,
+            aux_input_type_1=aux_input_type_1,
+            aux_input_type_10=aux_input_type_10,
+            aux_input_type_11=aux_input_type_11,
+            aux_input_type_12=aux_input_type_12,
+            aux_input_type_13=aux_input_type_13,
+            aux_input_type_2=aux_input_type_2,
+            aux_input_type_3=aux_input_type_3,
+            aux_input_type_4=aux_input_type_4,
+            aux_input_type_5=aux_input_type_5,
+            aux_input_type_6=aux_input_type_6,
+            aux_input_type_7=aux_input_type_7,
+            aux_input_type_8=aux_input_type_8,
+            aux_input_type_9=aux_input_type_9,
+            engine_hours=engine_hours,
+            external_ids=external_ids,
+            gateway_serial=gateway_serial,
+            gross_vehicle_weight=gross_vehicle_weight,
+            harsh_acceleration_setting_type=harsh_acceleration_setting_type,
+            license_plate=license_plate,
+            name=name,
+            notes=notes,
+            odometer_meters=odometer_meters,
+            static_assigned_driver_id=static_assigned_driver_id,
+            tag_ids=tag_ids,
+            vehicle_regulation_mode=vehicle_regulation_mode,
+            vehicle_type=vehicle_type,
+            vin=vin,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+class AsyncVehiclesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawVehiclesClient(client_wrapper=client_wrapper)
+        self.immobilizer = AsyncImmobilizerClient(client_wrapper=client_wrapper)
+
+        self.locations = AsyncLocationsClient(client_wrapper=client_wrapper)
+
+        self.stats = AsyncStatsClient(client_wrapper=client_wrapper)
+
+        self.tachograph_files = AsyncTachographFilesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawVehiclesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawVehiclesClient
+        """
+        return self._raw_client
+
+    async def list(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        after: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        attribute_value_ids: typing.Optional[str] = None,
+        updated_after_time: typing.Optional[str] = None,
+        created_after_time: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> VehiclesListVehiclesResponseBody:
+        """
+        Returns a list of all vehicles.
+
+         <b>Rate limit:</b> 25 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+
+        To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        after : typing.Optional[str]
+             If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        attribute_value_ids : typing.Optional[str]
+            A filter on the data based on this comma-separated list of attribute value IDs. Only entities associated with ALL of the referenced values will be returned (i.e. the intersection of the sets of entities with each value). Example: `attributeValueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544`
+
+        updated_after_time : typing.Optional[str]
+             A filter on data to have an updated at time after or equal to this specified time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        created_after_time : typing.Optional[str]
+             A filter on data to have a created at time after or equal to this specified time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        VehiclesListVehiclesResponseBody
+            OK response.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.vehicles.list()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list(
+            limit=limit,
+            after=after,
+            parent_tag_ids=parent_tag_ids,
+            tag_ids=tag_ids,
+            attribute_value_ids=attribute_value_ids,
+            updated_after_time=updated_after_time,
+            created_after_time=created_after_time,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def get(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> VehicleResponse:
+        """
+        Get information about a specific vehicle.
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+        Parameters
+        ----------
+        id : str
+            ID of the vehicle. This can either be the Samsara-specified ID, or an external ID. External IDs are customer specified key-value pairs created in the POST or PATCH requests of this resource, or automatically populated by fields on the vehicle. To specify an external ID as part of a path parameter, use the following format: `key:value`. For example, `maintenanceId:250020`. Automatically populated external IDs are prefixed with `samsara.`. For example, `samsara.vin:1HGBH41JXMN109186`.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        VehicleResponse
+            Returns the specified vehicle object.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.vehicles.get(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get(id, request_options=request_options)
+        return _response.data
+
+    async def update(
+        self,
+        id: str,
+        *,
+        attributes: typing.Optional[typing.Sequence[AttributeTiny]] = OMIT,
+        aux_input_type_1: typing.Optional[UpdateVehicleRequestAuxInputType1] = OMIT,
+        aux_input_type_10: typing.Optional[UpdateVehicleRequestAuxInputType10] = OMIT,
+        aux_input_type_11: typing.Optional[UpdateVehicleRequestAuxInputType11] = OMIT,
+        aux_input_type_12: typing.Optional[UpdateVehicleRequestAuxInputType12] = OMIT,
+        aux_input_type_13: typing.Optional[UpdateVehicleRequestAuxInputType13] = OMIT,
+        aux_input_type_2: typing.Optional[UpdateVehicleRequestAuxInputType2] = OMIT,
+        aux_input_type_3: typing.Optional[UpdateVehicleRequestAuxInputType3] = OMIT,
+        aux_input_type_4: typing.Optional[UpdateVehicleRequestAuxInputType4] = OMIT,
+        aux_input_type_5: typing.Optional[UpdateVehicleRequestAuxInputType5] = OMIT,
+        aux_input_type_6: typing.Optional[UpdateVehicleRequestAuxInputType6] = OMIT,
+        aux_input_type_7: typing.Optional[UpdateVehicleRequestAuxInputType7] = OMIT,
+        aux_input_type_8: typing.Optional[UpdateVehicleRequestAuxInputType8] = OMIT,
+        aux_input_type_9: typing.Optional[UpdateVehicleRequestAuxInputType9] = OMIT,
+        engine_hours: typing.Optional[int] = OMIT,
+        external_ids: typing.Optional[typing.Dict[str, str]] = OMIT,
+        gateway_serial: typing.Optional[UserIdentifierSerial] = OMIT,
+        gross_vehicle_weight: typing.Optional[GrossVehicleWeight] = OMIT,
+        harsh_acceleration_setting_type: typing.Optional[UpdateVehicleRequestHarshAccelerationSettingType] = OMIT,
+        license_plate: typing.Optional[str] = OMIT,
+        name: typing.Optional[str] = OMIT,
+        notes: typing.Optional[str] = OMIT,
+        odometer_meters: typing.Optional[int] = OMIT,
+        static_assigned_driver_id: typing.Optional[str] = OMIT,
+        tag_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        vehicle_regulation_mode: typing.Optional[VehicleRegulationMode] = OMIT,
+        vehicle_type: typing.Optional[VehicleType] = OMIT,
+        vin: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> VehicleResponse:
+        """
+        Updates the given Vehicle object.
+
+        **Note:** Vehicle objects are automatically created when Samsara Vehicle Gateways are installed. You cannot create a Vehicle object via API.
+
+        You are able to *update* many of the fields of a Vehicle.
+
+        **Note**: There are no required fields in the request body, and you only need to provide the fields you wish to update.
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        To use this endpoint, select **Write Vehicles** under the Vehicles category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+        Parameters
+        ----------
+        id : str
+            ID of the vehicle. This can either be the Samsara-specified ID, or an external ID. External IDs are customer specified key-value pairs created in the POST or PATCH requests of this resource, or automatically populated by fields on the vehicle. To specify an external ID as part of a path parameter, use the following format: `key:value`. For example, `maintenanceId:250020`. Automatically populated external IDs are prefixed with `samsara.`. For example, `samsara.vin:1HGBH41JXMN109186`.
+
+        attributes : typing.Optional[typing.Sequence[AttributeTiny]]
+
+        aux_input_type_1 : typing.Optional[UpdateVehicleRequestAuxInputType1]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_10 : typing.Optional[UpdateVehicleRequestAuxInputType10]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_11 : typing.Optional[UpdateVehicleRequestAuxInputType11]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_12 : typing.Optional[UpdateVehicleRequestAuxInputType12]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_13 : typing.Optional[UpdateVehicleRequestAuxInputType13]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_2 : typing.Optional[UpdateVehicleRequestAuxInputType2]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_3 : typing.Optional[UpdateVehicleRequestAuxInputType3]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_4 : typing.Optional[UpdateVehicleRequestAuxInputType4]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_5 : typing.Optional[UpdateVehicleRequestAuxInputType5]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_6 : typing.Optional[UpdateVehicleRequestAuxInputType6]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_7 : typing.Optional[UpdateVehicleRequestAuxInputType7]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_8 : typing.Optional[UpdateVehicleRequestAuxInputType8]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        aux_input_type_9 : typing.Optional[UpdateVehicleRequestAuxInputType9]
+            The type of <a href="https://kb.samsara.com/hc/en-us/articles/360043040512-Auxiliary-Inputs" target="_blank">auxiliary input</a> configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. Valid values: `None`, `Emergency Lights`, `Emergency Alarm`, `Stop Paddle`, `Power Take-Off`, `Plow`, `Sweeper`, `Salter`, `Reefer`, `Door`, `Boom`, `Auxiliary Engine`, `Generator`, `Eight-Way Lights`, `Panic Button`, `Privacy Button`, `Front Axle Drive`, `Weight Sensor`, `Other`, `Secondary Fuel Source`, `(ECU) Power Take-Off`.
+
+        engine_hours : typing.Optional[int]
+            A manual override for the vehicle's engine hours. You may only override a vehicle's engine hours if it cannot be read from on-board diagnostics. When you provide a manual engine hours override, Samsara will begin updating a vehicle's engine hours based on when the Samsara Vehicle Gateway is recieving power or not. Setting the value to 0 will unset the manual engine hours.
+
+        external_ids : typing.Optional[typing.Dict[str, str]]
+            The <a href="/docs/external-ids" target="_blank">external IDs</a> for the given object.
+
+        gateway_serial : typing.Optional[UserIdentifierSerial]
+
+        gross_vehicle_weight : typing.Optional[GrossVehicleWeight]
+
+        harsh_acceleration_setting_type : typing.Optional[UpdateVehicleRequestHarshAccelerationSettingType]
+            The harsh acceleration setting type. This setting influences the acceleration sensitivity from which a <a href="https://kb.samsara.com/hc/en-us/articles/360043051792-Safety-Event-Overview" target="_blank">harsh event</a> is triggered. **By default**, this setting is inferred by the Samsara Vehicle Gateway from the engine computer, but it may be set or updated through the Samsara Dashboard or the API at any time. If set to `off`, then no acceleration based harsh events are triggered for the vehicle. Valid values: `passengerCar`, `lightTruck`, `heavyDuty`, `off`, `automatic`.
+
+        license_plate : typing.Optional[str]
+            The license plate of the Vehicle. **By default**: empty. Can be set or updated through the Samsara Dashboard or the API at any time.
+
+        name : typing.Optional[str]
+            The human-readable name of the Vehicle. This is set by a fleet administrator and will appear in both Samsara’s cloud dashboard as well as the Samsara Driver mobile app. **By default**, this name is the serial number of the Samsara Vehicle Gateway. It can be set or updated through the Samsara Dashboard or through the API at any time.
+
+        notes : typing.Optional[str]
+            These are generic notes about the Vehicle. Empty by default. Can be set or updated through the Samsara Dashboard or the API at any time.
+
+        odometer_meters : typing.Optional[int]
+            A manual override for the vehicle's odometer. You may only override a vehicle's odometer if it cannot be read from on-board diagnostics. When you provide a manual odometer override, Samsara will begin updating a vehicle's odometer using GPS distance traveled since this override was set. See <a href="https://kb.samsara.com/hc/en-us/articles/115005273667" target="_blank">here</a> for more details.
+
+        static_assigned_driver_id : typing.Optional[str]
+            ID for the static assigned driver of the vehicle. Setting the value to 0 will unassign the current driver.
+
+        tag_ids : typing.Optional[typing.Sequence[str]]
+            An array of IDs of tags to associate with this vehicle. If your access to the API is scoped by one or more tags, this field is required to pass in.
+
+        vehicle_regulation_mode : typing.Optional[VehicleRegulationMode]
+
+        vehicle_type : typing.Optional[VehicleType]
+
+        vin : typing.Optional[str]
+            The VIN of the Vehicle. Most of the time, this will be automatically read from the engine computer by the Samsara Vehicle Gateway. It will be empty if it cannot be read. It can be set or updated through the Samsara Dashboard or the API at any time.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        VehicleResponse
+            Returns the specified vehicle object.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.vehicles.update(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.update(
+            id,
+            attributes=attributes,
+            aux_input_type_1=aux_input_type_1,
+            aux_input_type_10=aux_input_type_10,
+            aux_input_type_11=aux_input_type_11,
+            aux_input_type_12=aux_input_type_12,
+            aux_input_type_13=aux_input_type_13,
+            aux_input_type_2=aux_input_type_2,
+            aux_input_type_3=aux_input_type_3,
+            aux_input_type_4=aux_input_type_4,
+            aux_input_type_5=aux_input_type_5,
+            aux_input_type_6=aux_input_type_6,
+            aux_input_type_7=aux_input_type_7,
+            aux_input_type_8=aux_input_type_8,
+            aux_input_type_9=aux_input_type_9,
+            engine_hours=engine_hours,
+            external_ids=external_ids,
+            gateway_serial=gateway_serial,
+            gross_vehicle_weight=gross_vehicle_weight,
+            harsh_acceleration_setting_type=harsh_acceleration_setting_type,
+            license_plate=license_plate,
+            name=name,
+            notes=notes,
+            odometer_meters=odometer_meters,
+            static_assigned_driver_id=static_assigned_driver_id,
+            tag_ids=tag_ids,
+            vehicle_regulation_mode=vehicle_regulation_mode,
+            vehicle_type=vehicle_type,
+            vin=vin,
+            request_options=request_options,
+        )
+        return _response.data