samsara_api 0.0.228

data/lib/samsara_api/tags/client.rb

@@ -0,0 +1,651 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "../types/list_tags_response"
+require_relative "../types/tag_response"
+require "json"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require_relative "../../requests"
+
+module Samsara
+  class TagsClient
+  # @return [Samsara::RequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::TagsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Return all of the tags for 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 Tags** under the Setup & Administration
+#  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 request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::ListTagsResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.list
+    def list(limit: nil, after: 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 }.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)}/tags"
+end
+      Samsara::Types::ListTagsResponse.from_json(json_object: response.body)
+    end
+# Create a new tag for the organization. This may include up to 20,000 tagged
+#  entities.
+#  **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 Tags** under the Setup & Administration
+#  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 addresses [Array<String>] The addresses that belong to this tag.
+    # @param assets [Array<String>] The trailers, unpowered, and powered assets that belong to this tag.
+    # @param drivers [Array<String>] The drivers that belong to this tag.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param machines [Array<String>] The machines that belong to this tag.
+    # @param name [String] Name of this tag.
+    # @param parent_tag_id [String] If this tag is part a hierarchical tag tree, this is the ID of the parent tag,
+#  otherwise this will be omitted.
+    # @param sensors [Array<String>] The sensors that belong to this tag.
+    # @param vehicles [Array<String>] The vehicles that belong to this tag.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.create(name: "California")
+    def create(addresses: nil, assets: nil, drivers: nil, external_ids: nil, machines: nil, name:, parent_tag_id: nil, sensors: nil, vehicles: 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 || {}), addresses: addresses, assets: assets, drivers: drivers, externalIds: external_ids, machines: machines, name: name, parentTagId: parent_tag_id, sensors: sensors, vehicles: vehicles }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/tags"
+end
+      Samsara::Types::TagResponse.from_json(json_object: response.body)
+    end
+# Fetch a tag by id.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.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)}/tags/#{id}"
+end
+      Samsara::Types::TagResponse.from_json(json_object: response.body)
+    end
+# Update a tag with a new name and new members. This API call would replace all
+#  old members of a tag with new members specified in the request body.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @param addresses [Array<String>] The addresses that belong to this tag.
+    # @param assets [Array<String>] The trailers, unpowered, and powered assets that belong to this tag.
+    # @param drivers [Array<String>] The drivers that belong to this tag.
+    # @param machines [Array<String>] The machines that belong to this tag.
+    # @param name [String] Name of this tag.
+    # @param parent_tag_id [String] If this tag is part a hierarchical tag tree, this is the ID of the parent tag,
+#  otherwise this will be omitted.
+    # @param sensors [Array<String>] The sensors that belong to this tag.
+    # @param vehicles [Array<String>] The vehicles that belong to this tag.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.replace(id: "id")
+    def replace(id:, addresses: nil, assets: nil, drivers: nil, machines: nil, name: nil, parent_tag_id: nil, sensors: nil, vehicles: nil, request_options: nil)
+      response = @request_client.conn.put 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 || {}), addresses: addresses, assets: assets, drivers: drivers, machines: machines, name: name, parentTagId: parent_tag_id, sensors: sensors, vehicles: vehicles }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/tags/#{id}"
+end
+      Samsara::Types::TagResponse.from_json(json_object: response.body)
+    end
+# Permanently deletes a tag.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @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.tags.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)}/tags/#{id}"
+end
+      parsed_json = JSON.parse(response.body)
+      parsed_json
+    end
+# Update an existing tag. **Note** this implementation of patch uses [the JSON
+#  merge patch](https://tools.ietf.org/html/rfc7396) proposed standard.
+#  This means that any fields included in the patch request will _overwrite_
+#  fields which exist on the target resource.
+#  For arrays, this means any array included in the request will _replace_ the
+#  array that exists at the specified path, it will not _add_ to the existing
+#  array.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @param addresses [Array<String>] The addresses that belong to this tag.
+    # @param assets [Array<String>] The trailers, unpowered, and powered assets that belong to this tag.
+    # @param drivers [Array<String>] The drivers that belong to this tag.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param machines [Array<String>] The machines that belong to this tag.
+    # @param name [String] Name of this tag.
+    # @param parent_tag_id [String] If this tag is part a hierarchical tag tree, this is the ID of the parent tag,
+#  otherwise this will be omitted.
+    # @param sensors [Array<String>] The sensors that belong to this tag.
+    # @param vehicles [Array<String>] The vehicles that belong to this tag.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.patch(id: "id")
+    def patch(id:, addresses: nil, assets: nil, drivers: nil, external_ids: nil, machines: nil, name: nil, parent_tag_id: nil, sensors: nil, vehicles: 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 || {}), addresses: addresses, assets: assets, drivers: drivers, externalIds: external_ids, machines: machines, name: name, parentTagId: parent_tag_id, sensors: sensors, vehicles: vehicles }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/tags/#{id}"
+end
+      Samsara::Types::TagResponse.from_json(json_object: response.body)
+    end
+  end
+  class AsyncTagsClient
+  # @return [Samsara::AsyncRequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::AsyncTagsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Return all of the tags for 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 Tags** under the Setup & Administration
+#  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 request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::ListTagsResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.list
+    def list(limit: nil, after: 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 }.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)}/tags"
+end
+        Samsara::Types::ListTagsResponse.from_json(json_object: response.body)
+      end
+    end
+# Create a new tag for the organization. This may include up to 20,000 tagged
+#  entities.
+#  **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 Tags** under the Setup & Administration
+#  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 addresses [Array<String>] The addresses that belong to this tag.
+    # @param assets [Array<String>] The trailers, unpowered, and powered assets that belong to this tag.
+    # @param drivers [Array<String>] The drivers that belong to this tag.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param machines [Array<String>] The machines that belong to this tag.
+    # @param name [String] Name of this tag.
+    # @param parent_tag_id [String] If this tag is part a hierarchical tag tree, this is the ID of the parent tag,
+#  otherwise this will be omitted.
+    # @param sensors [Array<String>] The sensors that belong to this tag.
+    # @param vehicles [Array<String>] The vehicles that belong to this tag.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.create(name: "California")
+    def create(addresses: nil, assets: nil, drivers: nil, external_ids: nil, machines: nil, name:, parent_tag_id: nil, sensors: nil, vehicles: 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 || {}), addresses: addresses, assets: assets, drivers: drivers, externalIds: external_ids, machines: machines, name: name, parentTagId: parent_tag_id, sensors: sensors, vehicles: vehicles }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/tags"
+end
+        Samsara::Types::TagResponse.from_json(json_object: response.body)
+      end
+    end
+# Fetch a tag by id.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.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)}/tags/#{id}"
+end
+        Samsara::Types::TagResponse.from_json(json_object: response.body)
+      end
+    end
+# Update a tag with a new name and new members. This API call would replace all
+#  old members of a tag with new members specified in the request body.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @param addresses [Array<String>] The addresses that belong to this tag.
+    # @param assets [Array<String>] The trailers, unpowered, and powered assets that belong to this tag.
+    # @param drivers [Array<String>] The drivers that belong to this tag.
+    # @param machines [Array<String>] The machines that belong to this tag.
+    # @param name [String] Name of this tag.
+    # @param parent_tag_id [String] If this tag is part a hierarchical tag tree, this is the ID of the parent tag,
+#  otherwise this will be omitted.
+    # @param sensors [Array<String>] The sensors that belong to this tag.
+    # @param vehicles [Array<String>] The vehicles that belong to this tag.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.replace(id: "id")
+    def replace(id:, addresses: nil, assets: nil, drivers: nil, machines: nil, name: nil, parent_tag_id: nil, sensors: nil, vehicles: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.put 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 || {}), addresses: addresses, assets: assets, drivers: drivers, machines: machines, name: name, parentTagId: parent_tag_id, sensors: sensors, vehicles: vehicles }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/tags/#{id}"
+end
+        Samsara::Types::TagResponse.from_json(json_object: response.body)
+      end
+    end
+# Permanently deletes a tag.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @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.tags.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)}/tags/#{id}"
+end
+        parsed_json = JSON.parse(response.body)
+        parsed_json
+      end
+    end
+# Update an existing tag. **Note** this implementation of patch uses [the JSON
+#  merge patch](https://tools.ietf.org/html/rfc7396) proposed standard.
+#  This means that any fields included in the patch request will _overwrite_
+#  fields which exist on the target resource.
+#  For arrays, this means any array included in the request will _replace_ the
+#  array that exists at the specified path, it will not _add_ to the existing
+#  array.
+#  **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 Tags** under the Setup & Administration
+#  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 Tag. 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`.
+#  Automatically populated external IDs are prefixed with `samsara.`. For example,
+#  `samsara.name:ELD-exempt`.
+    # @param addresses [Array<String>] The addresses that belong to this tag.
+    # @param assets [Array<String>] The trailers, unpowered, and powered assets that belong to this tag.
+    # @param drivers [Array<String>] The drivers that belong to this tag.
+    # @param external_ids [Hash{String => String}] The [external IDs](https://developers.samsara.com/docs/external-ids) for the
+#  given object.
+    # @param machines [Array<String>] The machines that belong to this tag.
+    # @param name [String] Name of this tag.
+    # @param parent_tag_id [String] If this tag is part a hierarchical tag tree, this is the ID of the parent tag,
+#  otherwise this will be omitted.
+    # @param sensors [Array<String>] The sensors that belong to this tag.
+    # @param vehicles [Array<String>] The vehicles that belong to this tag.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::TagResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.tags.patch(id: "id")
+    def patch(id:, addresses: nil, assets: nil, drivers: nil, external_ids: nil, machines: nil, name: nil, parent_tag_id: nil, sensors: nil, vehicles: 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 || {}), addresses: addresses, assets: assets, drivers: drivers, externalIds: external_ids, machines: machines, name: name, parentTagId: parent_tag_id, sensors: sensors, vehicles: vehicles }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/tags/#{id}"
+end
+        Samsara::Types::TagResponse.from_json(json_object: response.body)
+      end
+    end
+  end
+end