samsara_api 0.0.228

data/lib/samsara_api/vehicles/client.rb

@@ -0,0 +1,817 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "immobilizer/client"
+require_relative "locations/client"
+require_relative "stats/client"
+require_relative "../types/vehicles_list_vehicles_response_body"
+require_relative "../types/vehicle_response"
+require_relative "../types/attribute_tiny"
+require_relative "types/update_vehicle_request_aux_input_type_1"
+require_relative "types/update_vehicle_request_aux_input_type_10"
+require_relative "types/update_vehicle_request_aux_input_type_11"
+require_relative "types/update_vehicle_request_aux_input_type_12"
+require_relative "types/update_vehicle_request_aux_input_type_13"
+require_relative "types/update_vehicle_request_aux_input_type_2"
+require_relative "types/update_vehicle_request_aux_input_type_3"
+require_relative "types/update_vehicle_request_aux_input_type_4"
+require_relative "types/update_vehicle_request_aux_input_type_5"
+require_relative "types/update_vehicle_request_aux_input_type_6"
+require_relative "types/update_vehicle_request_aux_input_type_7"
+require_relative "types/update_vehicle_request_aux_input_type_8"
+require_relative "types/update_vehicle_request_aux_input_type_9"
+require_relative "../types/gross_vehicle_weight"
+require_relative "types/update_vehicle_request_harsh_acceleration_setting_type"
+require_relative "../types/vehicle_regulation_mode"
+require "async"
+require "async"
+require "async"
+require_relative "../../requests"
+
+module Samsara
+  class VehiclesClient
+  # @return [Samsara::RequestClient] 
+    attr_reader :request_client
+  # @return [Samsara::Vehicles::ImmobilizerClient] 
+    attr_reader :immobilizer
+  # @return [Samsara::Vehicles::LocationsClient] 
+    attr_reader :locations
+  # @return [Samsara::Vehicles::StatsClient] 
+    attr_reader :stats
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::VehiclesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+      @immobilizer = Samsara::Vehicles::ImmobilizerClient.new(request_client: request_client)
+      @locations = Samsara::Vehicles::LocationsClient.new(request_client: request_client)
+      @stats = Samsara::Vehicles::StatsClient.new(request_client: request_client)
+    end
+# 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.
+    #
+    # @param limit [Integer] The limit for how many objects will be in the response. Default and max for this
+#  value is 512 objects.
+    # @param after [String] 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.
+    # @param parent_tag_ids [String] 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`
+    # @param tag_ids [String] A filter on the data based on this comma-separated list of tag IDs. Example:
+#  `tagIds=1234,5678`
+    # @param attribute_value_ids [String] 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:
+#  ueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544`
+    # @param attributes [String] A filter on the data to return entities having given attributes using name-value
+#  pair, separated by semicolon. 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:
+#  `attributes=ExampleAttributeName:some_value&attributes=SomeOtherAttr:123`
+    # @param updated_after_time [String] 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).
+    # @param created_after_time [String] 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).
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::VehiclesListVehiclesResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.vehicles.list
+    def list(limit: nil, after: nil, parent_tag_ids: nil, tag_ids: nil, attribute_value_ids: nil, attributes: nil, updated_after_time: nil, created_after_time: nil, request_options: nil)
+      response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "limit": limit, "after": after, "parentTagIds": parent_tag_ids, "tagIds": tag_ids, "attributeValueIds": attribute_value_ids, "attributes": attributes, "updatedAfterTime": updated_after_time, "createdAfterTime": created_after_time }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/vehicles"
+end
+      Samsara::Types::VehiclesListVehiclesResponseBody.from_json(json_object: response.body)
+    end
+# 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>
+    #
+    # @param id [String] 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`.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::VehicleResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.vehicles.get(id: "id")
+    def get(id:, request_options: nil)
+      response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/vehicles/#{id}"
+end
+      Samsara::Types::VehicleResponse.from_json(json_object: response.body)
+    end
+# 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>
+    #
+    # @param id [String] 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`.
+    # @param attributes [Array<Hash>] Request of type Array<Samsara::Types::AttributeTiny>, as a Hash
+    #   * :id (String) 
+    #   * :name (String) 
+    #   * :number_values (Array<Float>) 
+    #   * :string_values (Array<String>) 
+    # @param aux_input_type_1 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_10 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_11 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_12 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_13 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_2 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_3 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_4 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_5 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_6 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_7 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_8 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_9 [Samsara::Vehicles::Types::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`.
+    # @param engine_hours [Long] 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.
+    # @param external_ids [Hash{String => String}] The <a href="/docs/external-ids" target="_blank">external IDs</a> for the given
+#  object.
+    # @param gateway_serial [String] 
+    # @param gross_vehicle_weight [Hash] Request of type Samsara::Types::GrossVehicleWeight, as a Hash
+    #   * :unit (Samsara::Types::GrossVehicleWeightUnit) 
+    #   * :weight (Long) 
+    # @param harsh_acceleration_setting_type [Samsara::Vehicles::Types::UpdateVehicleRequestHarshAccelerationSettingType] The harsh acceleration setting type. This setting influences the acceleration
+#  sensitivity from which a <a
+#  ef="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`.
+    # @param license_plate [String] The license plate of the Vehicle. **By default**: empty. Can be set or updated
+#  through the Samsara Dashboard or the API at any time.
+    # @param name [String] 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.
+    # @param notes [String] 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.
+    # @param odometer_meters [Long] 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.
+    # @param static_assigned_driver_id [String] ID for the static assigned driver of the vehicle. Setting the value to 0 will
+#  unassign the current driver.
+    # @param tag_ids [Array<String>] 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.
+    # @param vehicle_regulation_mode [Samsara::Types::VehicleRegulationMode] 
+    # @param vehicle_type [String] 
+    # @param vin [String] 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.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::VehicleResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.vehicles.update(id: "id")
+    def update(id:, attributes: nil, aux_input_type_1: nil, aux_input_type_10: nil, aux_input_type_11: nil, aux_input_type_12: nil, aux_input_type_13: nil, aux_input_type_2: nil, aux_input_type_3: nil, aux_input_type_4: nil, aux_input_type_5: nil, aux_input_type_6: nil, aux_input_type_7: nil, aux_input_type_8: nil, aux_input_type_9: nil, engine_hours: nil, external_ids: nil, gateway_serial: nil, gross_vehicle_weight: nil, harsh_acceleration_setting_type: nil, license_plate: nil, name: nil, notes: nil, odometer_meters: nil, static_assigned_driver_id: nil, tag_ids: nil, vehicle_regulation_mode: nil, vehicle_type: nil, vin: nil, request_options: nil)
+      response = @request_client.conn.patch do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), attributes: attributes, auxInputType1: aux_input_type_1, auxInputType10: aux_input_type_10, auxInputType11: aux_input_type_11, auxInputType12: aux_input_type_12, auxInputType13: aux_input_type_13, auxInputType2: aux_input_type_2, auxInputType3: aux_input_type_3, auxInputType4: aux_input_type_4, auxInputType5: aux_input_type_5, auxInputType6: aux_input_type_6, auxInputType7: aux_input_type_7, auxInputType8: aux_input_type_8, auxInputType9: aux_input_type_9, engineHours: engine_hours, externalIds: external_ids, gatewaySerial: gateway_serial, grossVehicleWeight: gross_vehicle_weight, harshAccelerationSettingType: harsh_acceleration_setting_type, licensePlate: license_plate, name: name, notes: notes, odometerMeters: odometer_meters, staticAssignedDriverId: static_assigned_driver_id, tagIds: tag_ids, vehicleRegulationMode: vehicle_regulation_mode, vehicleType: vehicle_type, vin: vin }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/vehicles/#{id}"
+end
+      Samsara::Types::VehicleResponse.from_json(json_object: response.body)
+    end
+  end
+  class AsyncVehiclesClient
+  # @return [Samsara::AsyncRequestClient] 
+    attr_reader :request_client
+  # @return [Samsara::Vehicles::ImmobilizerClient] 
+    attr_reader :immobilizer
+  # @return [Samsara::Vehicles::LocationsClient] 
+    attr_reader :locations
+  # @return [Samsara::Vehicles::StatsClient] 
+    attr_reader :stats
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::AsyncVehiclesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+      @immobilizer = Samsara::Vehicles::AsyncImmobilizerClient.new(request_client: request_client)
+      @locations = Samsara::Vehicles::AsyncLocationsClient.new(request_client: request_client)
+      @stats = Samsara::Vehicles::AsyncStatsClient.new(request_client: request_client)
+    end
+# 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.
+    #
+    # @param limit [Integer] The limit for how many objects will be in the response. Default and max for this
+#  value is 512 objects.
+    # @param after [String] 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.
+    # @param parent_tag_ids [String] 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`
+    # @param tag_ids [String] A filter on the data based on this comma-separated list of tag IDs. Example:
+#  `tagIds=1234,5678`
+    # @param attribute_value_ids [String] 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:
+#  ueIds=076efac2-83b5-47aa-ba36-18428436dcac,6707b3f0-23b9-4fe3-b7be-11be34aea544`
+    # @param attributes [String] A filter on the data to return entities having given attributes using name-value
+#  pair, separated by semicolon. 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:
+#  `attributes=ExampleAttributeName:some_value&attributes=SomeOtherAttr:123`
+    # @param updated_after_time [String] 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).
+    # @param created_after_time [String] 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).
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::VehiclesListVehiclesResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.vehicles.list
+    def list(limit: nil, after: nil, parent_tag_ids: nil, tag_ids: nil, attribute_value_ids: nil, attributes: nil, updated_after_time: nil, created_after_time: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "limit": limit, "after": after, "parentTagIds": parent_tag_ids, "tagIds": tag_ids, "attributeValueIds": attribute_value_ids, "attributes": attributes, "updatedAfterTime": updated_after_time, "createdAfterTime": created_after_time }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/vehicles"
+end
+        Samsara::Types::VehiclesListVehiclesResponseBody.from_json(json_object: response.body)
+      end
+    end
+# 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>
+    #
+    # @param id [String] 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`.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::VehicleResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.vehicles.get(id: "id")
+    def get(id:, request_options: nil)
+      Async do
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/vehicles/#{id}"
+end
+        Samsara::Types::VehicleResponse.from_json(json_object: response.body)
+      end
+    end
+# 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>
+    #
+    # @param id [String] 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`.
+    # @param attributes [Array<Hash>] Request of type Array<Samsara::Types::AttributeTiny>, as a Hash
+    #   * :id (String) 
+    #   * :name (String) 
+    #   * :number_values (Array<Float>) 
+    #   * :string_values (Array<String>) 
+    # @param aux_input_type_1 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_10 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_11 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_12 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_13 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_2 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_3 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_4 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_5 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_6 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_7 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_8 [Samsara::Vehicles::Types::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`.
+    # @param aux_input_type_9 [Samsara::Vehicles::Types::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`.
+    # @param engine_hours [Long] 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.
+    # @param external_ids [Hash{String => String}] The <a href="/docs/external-ids" target="_blank">external IDs</a> for the given
+#  object.
+    # @param gateway_serial [String] 
+    # @param gross_vehicle_weight [Hash] Request of type Samsara::Types::GrossVehicleWeight, as a Hash
+    #   * :unit (Samsara::Types::GrossVehicleWeightUnit) 
+    #   * :weight (Long) 
+    # @param harsh_acceleration_setting_type [Samsara::Vehicles::Types::UpdateVehicleRequestHarshAccelerationSettingType] The harsh acceleration setting type. This setting influences the acceleration
+#  sensitivity from which a <a
+#  ef="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`.
+    # @param license_plate [String] The license plate of the Vehicle. **By default**: empty. Can be set or updated
+#  through the Samsara Dashboard or the API at any time.
+    # @param name [String] 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.
+    # @param notes [String] 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.
+    # @param odometer_meters [Long] 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.
+    # @param static_assigned_driver_id [String] ID for the static assigned driver of the vehicle. Setting the value to 0 will
+#  unassign the current driver.
+    # @param tag_ids [Array<String>] 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.
+    # @param vehicle_regulation_mode [Samsara::Types::VehicleRegulationMode] 
+    # @param vehicle_type [String] 
+    # @param vin [String] 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.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::VehicleResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.vehicles.update(id: "id")
+    def update(id:, attributes: nil, aux_input_type_1: nil, aux_input_type_10: nil, aux_input_type_11: nil, aux_input_type_12: nil, aux_input_type_13: nil, aux_input_type_2: nil, aux_input_type_3: nil, aux_input_type_4: nil, aux_input_type_5: nil, aux_input_type_6: nil, aux_input_type_7: nil, aux_input_type_8: nil, aux_input_type_9: nil, engine_hours: nil, external_ids: nil, gateway_serial: nil, gross_vehicle_weight: nil, harsh_acceleration_setting_type: nil, license_plate: nil, name: nil, notes: nil, odometer_meters: nil, static_assigned_driver_id: nil, tag_ids: nil, vehicle_regulation_mode: nil, vehicle_type: nil, vin: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.patch do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), attributes: attributes, auxInputType1: aux_input_type_1, auxInputType10: aux_input_type_10, auxInputType11: aux_input_type_11, auxInputType12: aux_input_type_12, auxInputType13: aux_input_type_13, auxInputType2: aux_input_type_2, auxInputType3: aux_input_type_3, auxInputType4: aux_input_type_4, auxInputType5: aux_input_type_5, auxInputType6: aux_input_type_6, auxInputType7: aux_input_type_7, auxInputType8: aux_input_type_8, auxInputType9: aux_input_type_9, engineHours: engine_hours, externalIds: external_ids, gatewaySerial: gateway_serial, grossVehicleWeight: gross_vehicle_weight, harshAccelerationSettingType: harsh_acceleration_setting_type, licensePlate: license_plate, name: name, notes: notes, odometerMeters: odometer_meters, staticAssignedDriverId: static_assigned_driver_id, tagIds: tag_ids, vehicleRegulationMode: vehicle_regulation_mode, vehicleType: vehicle_type, vin: vin }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/vehicles/#{id}"
+end
+        Samsara::Types::VehicleResponse.from_json(json_object: response.body)
+      end
+    end
+  end
+end