auth0 6.2.0 → 6.3.0

data/lib/auth0/event_streams/client.rb

@@ -20,6 +20,12 @@ module Auth0
       # @option params [String, nil] :from
       # @option params [Integer, nil] :take
       #
+      # @example
+      #   client.event_streams.list(
+      #     from: "from",
+      #     take: 1
+      #   )
+      #
       # @return [Auth0::Types::ListEventStreamsResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -47,7 +53,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListEventStreamsResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListEventStreamsResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -64,6 +70,18 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.event_streams.create(destination: {
+      #     type: "webhook",
+      #     configuration: {
+      #       webhook_endpoint: "webhook_endpoint",
+      #       webhook_authorization: {
+      #         method_: "basic",
+      #         username: "username"
+      #       }
+      #     }
+      #   })
+      #
       # @return [Auth0::Types::CreateEventStreamResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -81,7 +99,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateEventStreamResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateEventStreamResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -97,6 +115,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.event_streams.get(id: "id")
+      #
       # @return [Auth0::Types::GetEventStreamResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -113,7 +134,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetEventStreamResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetEventStreamResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -129,6 +150,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.event_streams.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -159,6 +183,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.event_streams.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateEventStreamResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -180,7 +207,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateEventStreamResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateEventStreamResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -196,6 +223,12 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.event_streams.test(
+      #     id: "id",
+      #     event_type: "connection.created"
+      #   )
+      #
       # @return [Auth0::Types::CreateEventStreamTestEventResponseContent]
       def test(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -217,7 +250,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateEventStreamTestEventResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateEventStreamTestEventResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/auth0/event_streams/deliveries/client.rb

@@ -26,6 +26,17 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.event_streams.deliveries.list(
+        #     id: "id",
+        #     statuses: "statuses",
+        #     event_types: "event_types",
+        #     date_from: "date_from",
+        #     date_to: "date_to",
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListEventStreamDeliveriesResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -57,7 +68,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListEventStreamDeliveriesResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListEventStreamDeliveriesResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -76,6 +87,12 @@ module Auth0
         # @option params [String] :id
         # @option params [String] :event_id
         #
+        # @example
+        #   client.event_streams.deliveries.get_history(
+        #     id: "id",
+        #     event_id: "event_id"
+        #   )
+        #
         # @return [Auth0::Types::GetEventStreamDeliveryHistoryResponseContent]
         def get_history(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -92,7 +109,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::GetEventStreamDeliveryHistoryResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetEventStreamDeliveryHistoryResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

data/lib/auth0/event_streams/redeliveries/client.rb

@@ -20,6 +20,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.event_streams.redeliveries.create(id: "id")
+        #
         # @return [Auth0::Types::CreateEventStreamRedeliveryResponseContent]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -41,7 +44,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::CreateEventStreamRedeliveryResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateEventStreamRedeliveryResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -58,6 +61,12 @@ module Auth0
         # @option params [String] :id
         # @option params [String] :event_id
         #
+        # @example
+        #   client.event_streams.redeliveries.create_by_id(
+        #     id: "id",
+        #     event_id: "event_id"
+        #   )
+        #
         # @return [untyped]
         def create_by_id(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/events/client.rb

@@ -23,6 +23,13 @@ module Auth0
       # @option params [String, nil] :from_timestamp
       # @option params [Auth0::Types::EventStreamSubscribeEventsEventTypeEnum, nil] :event_type
       #
+      # @example
+      #   client.events.subscribe(
+      #     from: "from",
+      #     from_timestamp: "from_timestamp",
+      #     event_type: ["connection.created"]
+      #   )
+      #
       # @return [untyped]
       def subscribe(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/experimentation/client.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Auth0
+  module Experimentation
+    class Client
+      # @param client [Auth0::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # @return [Auth0::Experiments::Client]
+      def experiments
+        @experiments ||= Auth0::Experimentation::Experiments::Client.new(client: @client)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Auth0
+  module Experimentation
+    module Experiments
+      class Client
+        # @param client [Auth0::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Increments the current ramp index to the requested target level. Up-only: the target must be the immediate
+        # next level in the schedule. Idempotent: calling with the current level returns success without writing
+        # anything.
+        #
+        # @param request_options [Hash]
+        # @param params [Auth0::Experimentation::Experiments::Types::AdvanceRampRequestContent]
+        # @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.experiments.advance_ramp(
+        #     id: "id",
+        #     target_level: 1
+        #   )
+        #
+        # @return [Auth0::Types::AdvanceRampResponseContent]
+        def advance_ramp(request_options: {}, **params)
+          params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          request_data = Auth0::Experimentation::Experiments::Types::AdvanceRampRequestContent.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: "POST",
+            path: "experimentation/experiments/#{URI.encode_uri_component(params[:id].to_s)}/advance-ramp",
+            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::AdvanceRampResponseContent.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/experiments/types/advance_ramp_request_content.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Auth0
+  module Experimentation
+    module Experiments
+      module Types
+        class AdvanceRampRequestContent < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :target_level, -> { Integer }, optional: false, 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)