auth0 6.2.0 → 6.4.0

data/lib/auth0/experimentation/segments/client.rb

@@ -0,0 +1,228 @@
+# frozen_string_literal: true
+
+module Auth0
+  module Experimentation
+    module Segments
+      class Client
+        # @param client [Auth0::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Retrieve a paginated list of segments for the tenant.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String, nil] :from
+        # @option params [Integer, nil] :take
+        # @option params [Auth0::Types::SegmentTypeFilterEnum, nil] :type
+        #
+        # @example
+        #   client.experimentation.segments.list(
+        #     from: "from",
+        #     take: 1,
+        #     type: "auth0"
+        #   )
+        #
+        # @return [Auth0::Types::ListSegmentsResponseContent]
+        def list(request_options: {}, **params)
+          params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["from"] = params[:from] if params.key?(:from)
+          query_params["take"] = params.fetch(:take, 50)
+          query_params["type"] = params[:type] if params.key?(:type)
+
+          Auth0::Internal::CursorItemIterator.new(
+            cursor_field: :next_,
+            item_field: :segments,
+            initial_cursor: query_params["from"]
+          ) do |next_cursor|
+            query_params["from"] = next_cursor
+            request = Auth0::Internal::JSON::Request.new(
+              base_url: request_options[:base_url],
+              method: "GET",
+              path: "experimentation/segments",
+              query: query_params,
+              request_options: request_options
+            )
+            begin
+              response = @client.send(request)
+            rescue Net::HTTPRequestTimeout
+              raise Auth0::Errors::TimeoutError
+            end
+            code = response.code.to_i
+            if code.between?(200, 299)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListSegmentsResponseContent.load(response.body))
+              [parsed_response, response]
+            else
+              error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
+              raise error_class.new(response.body, code: code)
+            end
+          end
+        end
+
+        # Create a new segment with rule-based membership criteria for use in experiments.
+        #
+        # @param request_options [Hash]
+        # @param params [Auth0::Experimentation::Segments::Types::CreateSegmentRequestContent]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        #
+        # @example
+        #   client.experimentation.segments.create(
+        #     name: "name",
+        #     rules: [{}]
+        #   )
+        #
+        # @return [Auth0::Types::CreateSegmentResponseContent]
+        def create(request_options: {}, **params)
+          params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          request = Auth0::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "experimentation/segments",
+            body: Auth0::Experimentation::Segments::Types::CreateSegmentRequestContent.new(params).to_h,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Auth0::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateSegmentResponseContent.load(response.body))
+          else
+            error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Retrieve a single segment by its ID.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :id
+        #
+        # @example
+        #   client.experimentation.segments.get(id: "id")
+        #
+        # @return [Auth0::Types::GetSegmentResponseContent]
+        def get(request_options: {}, **params)
+          params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          request = Auth0::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "experimentation/segments/#{URI.encode_uri_component(params[:id].to_s)}",
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Auth0::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetSegmentResponseContent.load(response.body))
+          else
+            error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Delete a segment by ID. Idempotent: returns 204 even if segment does not exist.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :id
+        #
+        # @example
+        #   client.experimentation.segments.delete(id: "id")
+        #
+        # @return [untyped]
+        def delete(request_options: {}, **params)
+          params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          request = Auth0::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "DELETE",
+            path: "experimentation/segments/#{URI.encode_uri_component(params[:id].to_s)}",
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Auth0::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          return if code.between?(200, 299)
+
+          error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+
+        # Partially update a segment by ID. Only provided fields are updated. Sending rules replaces the entire rules
+        # array.
+        #
+        # @param request_options [Hash]
+        # @param params [Auth0::Experimentation::Segments::Types::UpdateSegmentRequestContent]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :id
+        #
+        # @example
+        #   client.experimentation.segments.update(id: "id")
+        #
+        # @return [Auth0::Types::UpdateSegmentResponseContent]
+        def update(request_options: {}, **params)
+          params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          request_data = Auth0::Experimentation::Segments::Types::UpdateSegmentRequestContent.new(params).to_h
+          non_body_param_names = %w[id]
+          body = request_data.except(*non_body_param_names)
+
+          request = Auth0::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "PATCH",
+            path: "experimentation/segments/#{URI.encode_uri_component(params[:id].to_s)}",
+            body: body,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Auth0::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Auth0::Types::UpdateSegmentResponseContent.load(response.body))
+          else
+            error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/auth0/experimentation/segments/types/create_segment_request_content.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Auth0
+  module Experimentation
+    module Segments
+      module Types
+        class CreateSegmentRequestContent < Internal::Types::Model
+          field :name, -> { String }, optional: false, nullable: false
+
+          field :description, -> { String }, optional: true, nullable: false
+
+          field :rules, -> { Internal::Types::Array[Auth0::Types::SegmentRule] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/auth0/experimentation/segments/types/list_segments_request_parameters.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Auth0
+  module Experimentation
+    module Segments
+      module Types
+        class ListSegmentsRequestParameters < Internal::Types::Model
+          field :from, -> { String }, optional: true, nullable: false
+
+          field :take, -> { Integer }, optional: true, nullable: false
+
+          field :type, -> { Auth0::Types::SegmentTypeFilterEnum }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/auth0/experimentation/segments/types/update_segment_request_content.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Auth0
+  module Experimentation
+    module Segments
+      module Types
+        class UpdateSegmentRequestContent < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :name, -> { String }, optional: true, nullable: false
+
+          field :description, -> { String }, optional: true, nullable: false
+
+          field :rules, -> { Internal::Types::Array[Auth0::Types::SegmentRule] }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/auth0/flows/client.rb

@@ -23,6 +23,15 @@ module Auth0
       # @option params [Auth0::Types::ListFlowsRequestParametersHydrateEnum, nil] :hydrate
       # @option params [Boolean, nil] :synchronous
       #
+      # @example
+      #   client.flows.list(
+      #     page: 1,
+      #     per_page: 1,
+      #     include_totals: true,
+      #     hydrate: ["form_count"],
+      #     synchronous: true
+      #   )
+      #
       # @return [Auth0::Types::ListFlowsOffsetPaginatedResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -54,7 +63,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListFlowsOffsetPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListFlowsOffsetPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -71,6 +80,9 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.flows.create(name: "name")
+      #
       # @return [Auth0::Types::CreateFlowResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -88,7 +100,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateFlowResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateFlowResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -105,6 +117,12 @@ module Auth0
       # @option params [String] :id
       # @option params [Auth0::Types::GetFlowRequestParametersHydrateEnum, nil] :hydrate
       #
+      # @example
+      #   client.flows.get(
+      #     id: "id",
+      #     hydrate: ["form_count"]
+      #   )
+      #
       # @return [Auth0::Types::GetFlowResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -125,7 +143,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetFlowResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetFlowResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -141,6 +159,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.flows.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -171,6 +192,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.flows.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateFlowResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -192,7 +216,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateFlowResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateFlowResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/auth0/flows/executions/client.rb

@@ -23,6 +23,14 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.flows.executions.list(
+        #     flow_id: "flow_id",
+        #     include_totals: true,
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListFlowExecutionsPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -51,7 +59,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListFlowExecutionsPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListFlowExecutionsPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -71,6 +79,13 @@ module Auth0
         # @option params [String] :execution_id
         # @option params [Auth0::Types::GetFlowExecutionRequestParametersHydrateEnum, nil] :hydrate
         #
+        # @example
+        #   client.flows.executions.get(
+        #     flow_id: "flow_id",
+        #     execution_id: "execution_id",
+        #     hydrate: ["debug"]
+        #   )
+        #
         # @return [Auth0::Types::GetFlowExecutionResponseContent]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -91,7 +106,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::GetFlowExecutionResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetFlowExecutionResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -108,6 +123,12 @@ module Auth0
         # @option params [String] :flow_id
         # @option params [String] :execution_id
         #
+        # @example
+        #   client.flows.executions.delete(
+        #     flow_id: "flow_id",
+        #     execution_id: "execution_id"
+        #   )
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/flows/vault/connections/client.rb

@@ -23,6 +23,13 @@ module Auth0
           # @option params [Integer, nil] :per_page
           # @option params [Boolean, nil] :include_totals
           #
+          # @example
+          #   client.flows.vault.connections.list(
+          #     page: 1,
+          #     per_page: 1,
+          #     include_totals: true
+          #   )
+          #
           # @return [Auth0::Types::ListFlowsVaultConnectionsOffsetPaginatedResponseContent]
           def list(request_options: {}, **params)
             params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -52,7 +59,7 @@ module Auth0
               end
               code = response.code.to_i
               if code.between?(200, 299)
-                parsed_response = Auth0::Types::ListFlowsVaultConnectionsOffsetPaginatedResponseContent.load(response.body)
+                parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListFlowsVaultConnectionsOffsetPaginatedResponseContent.load(response.body))
                 [parsed_response, response]
               else
                 error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -69,6 +76,17 @@ module Auth0
           # @option request_options [Hash{String => Object}] :additional_body_parameters
           # @option request_options [Integer] :timeout_in_seconds
           #
+          # @example
+          #   client.flows.vault.connections.create(request: {
+          #     name: "name",
+          #     app_id: "ACTIVECAMPAIGN",
+          #     setup: {
+          #       type: "API_KEY",
+          #       api_key: "api_key",
+          #       base_url: "base_url"
+          #     }
+          #   })
+          #
           # @return [Auth0::Types::CreateFlowsVaultConnectionResponseContent]
           def create(request_options: {}, **params)
             params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -86,7 +104,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              Auth0::Types::CreateFlowsVaultConnectionResponseContent.load(response.body)
+              (response.body.to_s.empty? ? nil : Auth0::Types::CreateFlowsVaultConnectionResponseContent.load(response.body))
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
               raise error_class.new(response.body, code: code)
@@ -102,6 +120,9 @@ module Auth0
           # @option request_options [Integer] :timeout_in_seconds
           # @option params [String] :id
           #
+          # @example
+          #   client.flows.vault.connections.get(id: "id")
+          #
           # @return [Auth0::Types::GetFlowsVaultConnectionResponseContent]
           def get(request_options: {}, **params)
             params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -118,7 +139,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              Auth0::Types::GetFlowsVaultConnectionResponseContent.load(response.body)
+              (response.body.to_s.empty? ? nil : Auth0::Types::GetFlowsVaultConnectionResponseContent.load(response.body))
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
               raise error_class.new(response.body, code: code)
@@ -134,6 +155,9 @@ module Auth0
           # @option request_options [Integer] :timeout_in_seconds
           # @option params [String] :id
           #
+          # @example
+          #   client.flows.vault.connections.delete(id: "id")
+          #
           # @return [untyped]
           def delete(request_options: {}, **params)
             params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -164,6 +188,9 @@ module Auth0
           # @option request_options [Integer] :timeout_in_seconds
           # @option params [String] :id
           #
+          # @example
+          #   client.flows.vault.connections.update(id: "id")
+          #
           # @return [Auth0::Types::UpdateFlowsVaultConnectionResponseContent]
           def update(request_options: {}, **params)
             params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -185,7 +212,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              Auth0::Types::UpdateFlowsVaultConnectionResponseContent.load(response.body)
+              (response.body.to_s.empty? ? nil : Auth0::Types::UpdateFlowsVaultConnectionResponseContent.load(response.body))
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
               raise error_class.new(response.body, code: code)

data/lib/auth0/forms/client.rb

@@ -22,6 +22,14 @@ module Auth0
       # @option params [Boolean, nil] :include_totals
       # @option params [Auth0::Types::FormsRequestParametersHydrateEnum, nil] :hydrate
       #
+      # @example
+      #   client.forms.list(
+      #     page: 1,
+      #     per_page: 1,
+      #     include_totals: true,
+      #     hydrate: ["flow_count"]
+      #   )
+      #
       # @return [Auth0::Types::ListFormsOffsetPaginatedResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -52,7 +60,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListFormsOffsetPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListFormsOffsetPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -69,6 +77,9 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.forms.create(name: "name")
+      #
       # @return [Auth0::Types::CreateFormResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -86,7 +97,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateFormResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateFormResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -103,6 +114,12 @@ module Auth0
       # @option params [String] :id
       # @option params [Auth0::Types::FormsRequestParametersHydrateEnum, nil] :hydrate
       #
+      # @example
+      #   client.forms.get(
+      #     id: "id",
+      #     hydrate: ["flow_count"]
+      #   )
+      #
       # @return [Auth0::Types::GetFormResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -123,7 +140,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetFormResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetFormResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -139,6 +156,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.forms.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -169,6 +189,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.forms.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateFormResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -190,7 +213,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateFormResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateFormResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/auth0/groups/client.rb

@@ -29,6 +29,19 @@ module Auth0
       # @option params [String, nil] :from
       # @option params [Integer, nil] :take
       #
+      # @example
+      #   client.groups.list(
+      #     connection_id: "connection_id",
+      #     name: "name",
+      #     external_id: "external_id",
+      #     search: "search",
+      #     fields: "fields",
+      #     include_fields: true,
+      #     include_totals: true,
+      #     from: "from",
+      #     take: 1
+      #   )
+      #
       # @return [Auth0::Types::ListGroupsPaginatedResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -63,7 +76,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListGroupsPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListGroupsPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -83,6 +96,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.groups.get(id: "id")
+      #
       # @return [Auth0::Types::GetGroupResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -99,7 +115,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetGroupResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetGroupResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -117,6 +133,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.groups.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)