samsara_api 0.0.228

data/lib/samsara_api/addresses/client.rb

@@ -0,0 +1,596 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "../types/list_addresses_response"
+require_relative "types/create_address_request_address_types_item"
+require_relative "../types/create_address_request_geofence"
+require_relative "../types/address_response"
+require "json"
+require_relative "types/update_address_request_address_types_item"
+require_relative "../types/update_address_request_geofence"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require_relative "../../requests"
+
+module Samsara
+  class AddressesClient
+  # @return [Samsara::RequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::AddressesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Returns a list of all addresses in an organization.
+#  **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 Addresses** under the Addresses 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 limit [Long] 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 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::ListAddressesResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.list
+    def list(limit: nil, after: nil, parent_tag_ids: nil, tag_ids: 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, "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)}/addresses"
+end
+      Samsara::Types::ListAddressesResponse.from_json(json_object: response.body)
+    end
+# Creates a new address in the organization.
+#  **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 Addresses** under the Addresses 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 address_types [Array<Samsara::Addresses::Types::CreateAddressRequestAddressTypesItem>] Reporting location type associated with the address (used for ELD reporting
+#  purposes). Valid values: `yard`, `shortHaul`, `workforceSite`, `riskZone`,
+#  `industrialSite`, `alertsOnly`, `agricultureSource`.
+    # @param contact_ids [Array<String>] An array of Contact IDs associated with this Address.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param formatted_address [String] The full street address for this address/geofence, as it might be recognized by
+#  Google Maps.
+    # @param geofence [Hash] Request of type Samsara::Types::CreateAddressRequestGeofence, as a Hash
+    #   * :circle (Hash)
+    #     * :latitude (Float) 
+    #     * :longitude (Float) 
+    #     * :radius_meters (Long) 
+    #   * :polygon (Hash)
+    #     * :vertices (Array<Samsara::Types::AddressGeofencePolygonVertices>) 
+    #   * :settings (Hash)
+    #     * :show_addresses (Boolean) 
+    # @param latitude [Float] Latitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param longitude [Float] Longitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param name [String] Name of the address.
+    # @param notes [String] Notes about the address.
+    # @param tag_ids [Array<String>] An array of IDs of tags to associate with this address.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::AddressResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.create(
+#    formatted_address: "350 Rhode Island St, San Francisco, CA",
+#    geofence: {  },
+#    name: "Samsara HQ"
+#  )
+    def create(address_types: nil, contact_ids: nil, external_ids: nil, formatted_address:, geofence:, latitude: nil, longitude: nil, name:, notes: nil, tag_ids: nil, request_options: nil)
+      response = @request_client.conn.post 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 || {}), addressTypes: address_types, contactIds: contact_ids, externalIds: external_ids, formattedAddress: formatted_address, geofence: geofence, latitude: latitude, longitude: longitude, name: name, notes: notes, tagIds: tag_ids }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/addresses"
+end
+      Samsara::Types::AddressResponse.from_json(json_object: response.body)
+    end
+# Returns a specific address.
+#  **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 Addresses** under the Addresses 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 Address. This can either be the Samsara-provided ID or an external ID.
+#  External IDs are customer-specified key-value pairs created in the POST or PATCH
+#  requests of this resource. To specify an external ID as part of a path
+#  parameter, use the following format: `key:value`. For example, `crmId:abc123`
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::AddressResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.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)}/addresses/#{id}"
+end
+      Samsara::Types::AddressResponse.from_json(json_object: response.body)
+    end
+# Delete a specific address.
+#  **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 Addresses** under the Addresses 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 Address. This can either be the Samsara-provided ID or an external ID.
+#  External IDs are customer-specified key-value pairs created in the POST or PATCH
+#  requests of this resource. To specify an external ID as part of a path
+#  parameter, use the following format: `key:value`. For example, `crmId:abc123`
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Object]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.delete(id: "id")
+    def delete(id:, request_options: nil)
+      response = @request_client.conn.delete 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)}/addresses/#{id}"
+end
+      parsed_json = JSON.parse(response.body)
+      parsed_json
+    end
+# Update a specific address.
+#  **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 Addresses** under the Addresses 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 Address. This can either be the Samsara-provided ID or an external ID.
+#  External IDs are customer-specified key-value pairs created in the POST or PATCH
+#  requests of this resource. To specify an external ID as part of a path
+#  parameter, use the following format: `key:value`. For example, `crmId:abc123`
+    # @param address_types [Array<Samsara::Addresses::Types::UpdateAddressRequestAddressTypesItem>] Reporting location type associated with the address (used for ELD reporting
+#  purposes). Valid values: `yard`, `shortHaul`, `workforceSite`, `riskZone`,
+#  `industrialSite`, `alertsOnly`, `agricultureSource`.
+    # @param contact_ids [Array<String>] An array of Contact IDs associated with this Address.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param formatted_address [String] The full street address for this address/geofence, as it might be recognized by
+#  Google Maps.
+    # @param geofence [Hash] Request of type Samsara::Types::UpdateAddressRequestGeofence, as a Hash
+    #   * :circle (Hash)
+    #     * :latitude (Float) 
+    #     * :longitude (Float) 
+    #     * :radius_meters (Long) 
+    #   * :polygon (Hash)
+    #     * :vertices (Array<Samsara::Types::AddressGeofencePolygonVertices>) 
+    #   * :settings (Hash)
+    #     * :show_addresses (Boolean) 
+    # @param latitude [Float] Latitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param longitude [Float] Longitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param name [String] Name of the address.
+    # @param notes [String] Notes about the address.
+    # @param tag_ids [Array<String>] An array of IDs of tags to associate with this address.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::AddressResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.update(id: "id")
+    def update(id:, address_types: nil, contact_ids: nil, external_ids: nil, formatted_address: nil, geofence: nil, latitude: nil, longitude: nil, name: nil, notes: nil, tag_ids: 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 || {}), addressTypes: address_types, contactIds: contact_ids, externalIds: external_ids, formattedAddress: formatted_address, geofence: geofence, latitude: latitude, longitude: longitude, name: name, notes: notes, tagIds: tag_ids }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/addresses/#{id}"
+end
+      Samsara::Types::AddressResponse.from_json(json_object: response.body)
+    end
+  end
+  class AsyncAddressesClient
+  # @return [Samsara::AsyncRequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::AsyncAddressesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Returns a list of all addresses in an organization.
+#  **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 Addresses** under the Addresses 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 limit [Long] 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 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::ListAddressesResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.list
+    def list(limit: nil, after: nil, parent_tag_ids: nil, tag_ids: 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, "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)}/addresses"
+end
+        Samsara::Types::ListAddressesResponse.from_json(json_object: response.body)
+      end
+    end
+# Creates a new address in the organization.
+#  **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 Addresses** under the Addresses 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 address_types [Array<Samsara::Addresses::Types::CreateAddressRequestAddressTypesItem>] Reporting location type associated with the address (used for ELD reporting
+#  purposes). Valid values: `yard`, `shortHaul`, `workforceSite`, `riskZone`,
+#  `industrialSite`, `alertsOnly`, `agricultureSource`.
+    # @param contact_ids [Array<String>] An array of Contact IDs associated with this Address.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param formatted_address [String] The full street address for this address/geofence, as it might be recognized by
+#  Google Maps.
+    # @param geofence [Hash] Request of type Samsara::Types::CreateAddressRequestGeofence, as a Hash
+    #   * :circle (Hash)
+    #     * :latitude (Float) 
+    #     * :longitude (Float) 
+    #     * :radius_meters (Long) 
+    #   * :polygon (Hash)
+    #     * :vertices (Array<Samsara::Types::AddressGeofencePolygonVertices>) 
+    #   * :settings (Hash)
+    #     * :show_addresses (Boolean) 
+    # @param latitude [Float] Latitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param longitude [Float] Longitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param name [String] Name of the address.
+    # @param notes [String] Notes about the address.
+    # @param tag_ids [Array<String>] An array of IDs of tags to associate with this address.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::AddressResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.create(
+#    formatted_address: "350 Rhode Island St, San Francisco, CA",
+#    geofence: {  },
+#    name: "Samsara HQ"
+#  )
+    def create(address_types: nil, contact_ids: nil, external_ids: nil, formatted_address:, geofence:, latitude: nil, longitude: nil, name:, notes: nil, tag_ids: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.post 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 || {}), addressTypes: address_types, contactIds: contact_ids, externalIds: external_ids, formattedAddress: formatted_address, geofence: geofence, latitude: latitude, longitude: longitude, name: name, notes: notes, tagIds: tag_ids }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/addresses"
+end
+        Samsara::Types::AddressResponse.from_json(json_object: response.body)
+      end
+    end
+# Returns a specific address.
+#  **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 Addresses** under the Addresses 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 Address. This can either be the Samsara-provided ID or an external ID.
+#  External IDs are customer-specified key-value pairs created in the POST or PATCH
+#  requests of this resource. To specify an external ID as part of a path
+#  parameter, use the following format: `key:value`. For example, `crmId:abc123`
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::AddressResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.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)}/addresses/#{id}"
+end
+        Samsara::Types::AddressResponse.from_json(json_object: response.body)
+      end
+    end
+# Delete a specific address.
+#  **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 Addresses** under the Addresses 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 Address. This can either be the Samsara-provided ID or an external ID.
+#  External IDs are customer-specified key-value pairs created in the POST or PATCH
+#  requests of this resource. To specify an external ID as part of a path
+#  parameter, use the following format: `key:value`. For example, `crmId:abc123`
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Object]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.delete(id: "id")
+    def delete(id:, request_options: nil)
+      Async do
+        response = @request_client.conn.delete 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)}/addresses/#{id}"
+end
+        parsed_json = JSON.parse(response.body)
+        parsed_json
+      end
+    end
+# Update a specific address.
+#  **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 Addresses** under the Addresses 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 Address. This can either be the Samsara-provided ID or an external ID.
+#  External IDs are customer-specified key-value pairs created in the POST or PATCH
+#  requests of this resource. To specify an external ID as part of a path
+#  parameter, use the following format: `key:value`. For example, `crmId:abc123`
+    # @param address_types [Array<Samsara::Addresses::Types::UpdateAddressRequestAddressTypesItem>] Reporting location type associated with the address (used for ELD reporting
+#  purposes). Valid values: `yard`, `shortHaul`, `workforceSite`, `riskZone`,
+#  `industrialSite`, `alertsOnly`, `agricultureSource`.
+    # @param contact_ids [Array<String>] An array of Contact IDs associated with this Address.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param formatted_address [String] The full street address for this address/geofence, as it might be recognized by
+#  Google Maps.
+    # @param geofence [Hash] Request of type Samsara::Types::UpdateAddressRequestGeofence, as a Hash
+    #   * :circle (Hash)
+    #     * :latitude (Float) 
+    #     * :longitude (Float) 
+    #     * :radius_meters (Long) 
+    #   * :polygon (Hash)
+    #     * :vertices (Array<Samsara::Types::AddressGeofencePolygonVertices>) 
+    #   * :settings (Hash)
+    #     * :show_addresses (Boolean) 
+    # @param latitude [Float] Latitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param longitude [Float] Longitude of the address. Will be geocoded from `formattedAddress` if not
+#  provided.
+    # @param name [String] Name of the address.
+    # @param notes [String] Notes about the address.
+    # @param tag_ids [Array<String>] An array of IDs of tags to associate with this address.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::AddressResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.addresses.update(id: "id")
+    def update(id:, address_types: nil, contact_ids: nil, external_ids: nil, formatted_address: nil, geofence: nil, latitude: nil, longitude: nil, name: nil, notes: nil, tag_ids: 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 || {}), addressTypes: address_types, contactIds: contact_ids, externalIds: external_ids, formattedAddress: formatted_address, geofence: geofence, latitude: latitude, longitude: longitude, name: name, notes: notes, tagIds: tag_ids }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/addresses/#{id}"
+end
+        Samsara::Types::AddressResponse.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/samsara_api/addresses/types/create_address_request_address_types_item.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Samsara
+  module Addresses
+    module Types
+      class CreateAddressRequestAddressTypesItem
+
+        YARD = "yard"
+        SHORT_HAUL = "shortHaul"
+        WORKFORCE_SITE = "workforceSite"
+        RISK_ZONE = "riskZone"
+        INDUSTRIAL_SITE = "industrialSite"
+        ALERTS_ONLY = "alertsOnly"
+        AGRICULTURE_SOURCE = "agricultureSource"
+
+      end
+    end
+  end
+end

data/lib/samsara_api/addresses/types/update_address_request_address_types_item.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Samsara
+  module Addresses
+    module Types
+      class UpdateAddressRequestAddressTypesItem
+
+        YARD = "yard"
+        SHORT_HAUL = "shortHaul"
+        WORKFORCE_SITE = "workforceSite"
+        RISK_ZONE = "riskZone"
+        INDUSTRIAL_SITE = "industrialSite"
+        ALERTS_ONLY = "alertsOnly"
+        AGRICULTURE_SOURCE = "agricultureSource"
+
+      end
+    end
+  end
+end