samsara_api 0.0.228

data/lib/samsara_api/defect_types/client.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "../types/dvir_defect_type_get_defect_types_response_body"
+require "async"
+require_relative "../../requests"
+
+module Samsara
+  class DefectTypesClient
+  # @return [Samsara::RequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::DefectTypesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Get DVIR defect types.
+#  <b>Rate limit:</b> 5 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 Defect Types** under the Maintenance
+#  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 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 limit [Integer] The limit for how many objects will be in the response. Default and max for this
+#  value is 512 objects.
+    # @param ids [String] A filter on the data based on this comma-separated list of defect type IDs.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DvirDefectTypeGetDefectTypesResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defect_types.list
+    def list(after: nil, limit: nil, ids: 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 || {}), "after": after, "limit": limit, "ids": ids }.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)}/defect-types"
+end
+      Samsara::Types::DvirDefectTypeGetDefectTypesResponseBody.from_json(json_object: response.body)
+    end
+  end
+  class AsyncDefectTypesClient
+  # @return [Samsara::AsyncRequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::AsyncDefectTypesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Get DVIR defect types.
+#  <b>Rate limit:</b> 5 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 Defect Types** under the Maintenance
+#  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 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 limit [Integer] The limit for how many objects will be in the response. Default and max for this
+#  value is 512 objects.
+    # @param ids [String] A filter on the data based on this comma-separated list of defect type IDs.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DvirDefectTypeGetDefectTypesResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defect_types.list
+    def list(after: nil, limit: nil, ids: 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 || {}), "after": after, "limit": limit, "ids": ids }.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)}/defect-types"
+end
+        Samsara::Types::DvirDefectTypeGetDefectTypesResponseBody.from_json(json_object: response.body)
+      end
+    end
+  end
+end

data/lib/samsara_api/defects/client.rb

@@ -0,0 +1,441 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "../types/dvir_defect_stream_defects_response_body"
+require_relative "../types/dvir_defect_get_defect_response_body"
+require_relative "../types/defects_response"
+require_relative "../types/resolved_by"
+require_relative "../types/defect_response"
+require "async"
+require "async"
+require "async"
+require "async"
+require_relative "../../requests"
+
+module Samsara
+  class DefectsClient
+  # @return [Samsara::RequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::DefectsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Stream DVIR defects.
+#  <b>Rate limit:</b> 5 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 Defects** under the Maintenance 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 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 limit [Integer] The limit for how many objects will be in the response. Default and max for this
+#  value is 200 objects.
+    # @param start_time [String] Required RFC 3339 timestamp to begin the feed or history by `updatedAtTime` at
+#  `startTime`.
+    # @param end_time [String] Optional RFC 3339 timestamp. If not provided then the endpoint behaves as an
+#  unending feed of changes.
+    # @param include_external_ids [Boolean] Optional boolean indicating whether to return external IDs on supported entities
+    # @param is_resolved [Boolean] Boolean value for whether filter defects by resolved status.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DvirDefectStreamDefectsResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.stream(start_time: "startTime")
+    def stream(after: nil, limit: nil, start_time:, end_time: nil, include_external_ids: nil, is_resolved: 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 || {}), "after": after, "limit": limit, "startTime": start_time, "endTime": end_time, "includeExternalIds": include_external_ids, "isResolved": is_resolved }.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)}/defects/stream"
+end
+      Samsara::Types::DvirDefectStreamDefectsResponseBody.from_json(json_object: response.body)
+    end
+# Get a single DVIR defect by ID.
+#  <b>Rate limit:</b> 10 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 Defects** under the Maintenance 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 id [String] The unique ID of the DVIR defect.
+    # @param include_external_ids [Boolean] Optional boolean indicating whether to return external IDs on supported entities
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DvirDefectGetDefectResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.get(id: "id")
+    def get(id:, include_external_ids: 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 || {}), "includeExternalIds": include_external_ids }.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)}/defects/#{id}"
+end
+      Samsara::Types::DvirDefectGetDefectResponseBody.from_json(json_object: response.body)
+    end
+# **Note: This is a legacy endpoint, consider using [this
+#  endpoint](https://developers.samsara.com/reference/streamdefects) instead. The
+#  endpoint will continue to function as documented.**
+#  Returns a list of DVIR defects in an organization, filtered by creation time.
+#  The maximum time period you can query for is 30 days.
+#  **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 Defects** under the Maintenance 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 start_time [String] A start 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). *The maximum time period you can query for is 30
+#  days.*
+    # @param end_time [String] An end 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). *The maximum time period you can query for is 30
+#  days.*
+    # @param is_resolved [Boolean] A filter on the data based on resolution status. Example: `isResolved=true`
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DefectsResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.history(start_time: "startTime", end_time: "endTime")
+    def history(limit: nil, after: nil, start_time:, end_time:, is_resolved: 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, "startTime": start_time, "endTime": end_time, "isResolved": is_resolved }.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/defects/history"
+end
+      Samsara::Types::DefectsResponse.from_json(json_object: response.body)
+    end
+# Updates a given defect. Can be used to resolve a defect by marking its
+#  `isResolved` field to `true`.
+#  **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 Defects** under the Maintenance 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 defect.
+    # @param is_resolved [Boolean] Resolves the defect. Must be `true`.
+    # @param mechanic_notes [String] The mechanics notes on the defect.
+    # @param resolved_at_time [String] Time when defect was resolved. Defaults to now if not provided. UTC timestamp in
+#  RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
+    # @param resolved_by [Hash] Request of type Samsara::Types::ResolvedBy, as a Hash
+    #   * :id (String) 
+    #   * :type (String) 
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DefectResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.update(id: "id")
+    def update(id:, is_resolved: nil, mechanic_notes: nil, resolved_at_time: nil, resolved_by: 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 || {}), isResolved: is_resolved, mechanicNotes: mechanic_notes, resolvedAtTime: resolved_at_time, resolvedBy: resolved_by }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/defects/#{id}"
+end
+      Samsara::Types::DefectResponse.from_json(json_object: response.body)
+    end
+  end
+  class AsyncDefectsClient
+  # @return [Samsara::AsyncRequestClient] 
+    attr_reader :request_client
+
+
+    # @param request_client [Samsara::RequestClient] 
+    # @return [Samsara::AsyncDefectsClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+# Stream DVIR defects.
+#  <b>Rate limit:</b> 5 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 Defects** under the Maintenance 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 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 limit [Integer] The limit for how many objects will be in the response. Default and max for this
+#  value is 200 objects.
+    # @param start_time [String] Required RFC 3339 timestamp to begin the feed or history by `updatedAtTime` at
+#  `startTime`.
+    # @param end_time [String] Optional RFC 3339 timestamp. If not provided then the endpoint behaves as an
+#  unending feed of changes.
+    # @param include_external_ids [Boolean] Optional boolean indicating whether to return external IDs on supported entities
+    # @param is_resolved [Boolean] Boolean value for whether filter defects by resolved status.
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DvirDefectStreamDefectsResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.stream(start_time: "startTime")
+    def stream(after: nil, limit: nil, start_time:, end_time: nil, include_external_ids: nil, is_resolved: 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 || {}), "after": after, "limit": limit, "startTime": start_time, "endTime": end_time, "includeExternalIds": include_external_ids, "isResolved": is_resolved }.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)}/defects/stream"
+end
+        Samsara::Types::DvirDefectStreamDefectsResponseBody.from_json(json_object: response.body)
+      end
+    end
+# Get a single DVIR defect by ID.
+#  <b>Rate limit:</b> 10 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 Defects** under the Maintenance 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 id [String] The unique ID of the DVIR defect.
+    # @param include_external_ids [Boolean] Optional boolean indicating whether to return external IDs on supported entities
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DvirDefectGetDefectResponseBody]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.get(id: "id")
+    def get(id:, include_external_ids: 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 || {}), "includeExternalIds": include_external_ids }.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)}/defects/#{id}"
+end
+        Samsara::Types::DvirDefectGetDefectResponseBody.from_json(json_object: response.body)
+      end
+    end
+# **Note: This is a legacy endpoint, consider using [this
+#  endpoint](https://developers.samsara.com/reference/streamdefects) instead. The
+#  endpoint will continue to function as documented.**
+#  Returns a list of DVIR defects in an organization, filtered by creation time.
+#  The maximum time period you can query for is 30 days.
+#  **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 Defects** under the Maintenance 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 start_time [String] A start 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). *The maximum time period you can query for is 30
+#  days.*
+    # @param end_time [String] An end 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). *The maximum time period you can query for is 30
+#  days.*
+    # @param is_resolved [Boolean] A filter on the data based on resolution status. Example: `isResolved=true`
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DefectsResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.history(start_time: "startTime", end_time: "endTime")
+    def history(limit: nil, after: nil, start_time:, end_time:, is_resolved: 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, "startTime": start_time, "endTime": end_time, "isResolved": is_resolved }.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/defects/history"
+end
+        Samsara::Types::DefectsResponse.from_json(json_object: response.body)
+      end
+    end
+# Updates a given defect. Can be used to resolve a defect by marking its
+#  `isResolved` field to `true`.
+#  **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 Defects** under the Maintenance 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 defect.
+    # @param is_resolved [Boolean] Resolves the defect. Must be `true`.
+    # @param mechanic_notes [String] The mechanics notes on the defect.
+    # @param resolved_at_time [String] Time when defect was resolved. Defaults to now if not provided. UTC timestamp in
+#  RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
+    # @param resolved_by [Hash] Request of type Samsara::Types::ResolvedBy, as a Hash
+    #   * :id (String) 
+    #   * :type (String) 
+    # @param request_options [Samsara::RequestOptions] 
+    # @return [Samsara::Types::DefectResponse]
+    # @example
+#  api = Samsara::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Samsara::Environment::PRODUCTION_API,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.defects.update(id: "id")
+    def update(id:, is_resolved: nil, mechanic_notes: nil, resolved_at_time: nil, resolved_by: 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 || {}), isResolved: is_resolved, mechanicNotes: mechanic_notes, resolvedAtTime: resolved_at_time, resolvedBy: resolved_by }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/fleet/defects/#{id}"
+end
+        Samsara::Types::DefectResponse.from_json(json_object: response.body)
+      end
+    end
+  end
+end