auth0 6.2.0 → 6.3.0

data/lib/auth0/resource_servers/client.rb

@@ -25,6 +25,15 @@ module Auth0
       # @option params [Boolean, nil] :include_totals
       # @option params [Boolean, nil] :include_fields
       #
+      # @example
+      #   client.resource_servers.list(
+      #     identifiers: ["identifiers"],
+      #     page: 1,
+      #     per_page: 1,
+      #     include_totals: true,
+      #     include_fields: true
+      #   )
+      #
       # @return [Auth0::Types::ListResourceServerOffsetPaginatedResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -56,7 +65,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListResourceServerOffsetPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListResourceServerOffsetPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -76,6 +85,9 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.resource_servers.create(identifier: "identifier")
+      #
       # @return [Auth0::Types::CreateResourceServerResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -93,13 +105,87 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateResourceServerResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateResourceServerResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
         end
       end
 
+      # Search resource servers using SCIM or Lucene filter syntax with low-latency, eventually consistent results. Use
+      # the parser parameter to specify "scim" or "lucene" syntax (default: "lucene"). This endpoint provides an
+      # alternative to the standard GET /resource-servers endpoint with better performance for complex queries.
+      # Results may not reflect recent updates immediately.
+      #
+      # The `signing_secret` field is not supported by this endpoint.
+      #
+      # @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] :q
+      # @option params [Auth0::Types::SearchParserEnum, nil] :parser
+      # @option params [String, nil] :fields
+      # @option params [Boolean, nil] :include_fields
+      # @option params [Integer, nil] :take
+      # @option params [String, nil] :from
+      # @option params [Auth0::Types::ResourceServerSortFieldEnum, nil] :sort
+      #
+      # @example
+      #   client.resource_servers.search(
+      #     q: "q",
+      #     parser: "scim",
+      #     fields: "fields",
+      #     include_fields: true,
+      #     take: 1,
+      #     from: "from",
+      #     sort: "identifier"
+      #   )
+      #
+      # @return [Auth0::Types::SearchResourceServersResponseContent]
+      def search(request_options: {}, **params)
+        params = Auth0::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["q"] = params[:q] if params.key?(:q)
+        query_params["parser"] = params[:parser] if params.key?(:parser)
+        query_params["fields"] = params[:fields] if params.key?(:fields)
+        query_params["include_fields"] = params[:include_fields] if params.key?(:include_fields)
+        query_params["take"] = params.fetch(:take, 50)
+        query_params["from"] = params[:from] if params.key?(:from)
+        query_params["sort"] = params[:sort] if params.key?(:sort)
+
+        Auth0::Internal::CursorItemIterator.new(
+          cursor_field: :next_,
+          item_field: :resource_servers,
+          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: "resource-servers/search",
+            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::SearchResourceServersResponseContent.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
+
       # Retrieve <a href="https://auth0.com/docs/apis">API</a> details with the given ID.
       #
       # @param request_options [Hash]
@@ -112,6 +198,12 @@ module Auth0
       # @option params [String] :id
       # @option params [Boolean, nil] :include_fields
       #
+      # @example
+      #   client.resource_servers.get(
+      #     id: "id",
+      #     include_fields: true
+      #   )
+      #
       # @return [Auth0::Types::GetResourceServerResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -132,7 +224,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetResourceServerResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetResourceServerResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -151,6 +243,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.resource_servers.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -184,6 +279,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.resource_servers.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateResourceServerResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -205,7 +303,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateResourceServerResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateResourceServerResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/auth0/resource_servers/types/create_resource_server_request_content.rb

@@ -22,12 +22,16 @@ module Auth0
 
         field :token_lifetime, -> { Integer }, optional: true, nullable: false
 
+        field :token_lifetime_for_anonymous_access_tokens, -> { Integer }, optional: true, nullable: false
+
         field :token_dialect, -> { Auth0::Types::ResourceServerTokenDialectSchemaEnum }, optional: true, nullable: false
 
         field :skip_consent_for_verifiable_first_party_clients, -> { Internal::Types::Boolean }, optional: true, nullable: false
 
         field :enforce_policies, -> { Internal::Types::Boolean }, optional: true, nullable: false
 
+        field :access_token, -> { Auth0::Types::ResourceServerAccessToken }, optional: true, nullable: false
+
         field :token_encryption, -> { Auth0::Types::ResourceServerTokenEncryption }, optional: true, nullable: false
 
         field :consent_policy, -> { Auth0::Types::ResourceServerConsentPolicyEnum }, optional: true, nullable: false

data/lib/auth0/resource_servers/types/search_resource_servers_request_parameters.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Auth0
+  module ResourceServers
+    module Types
+      class SearchResourceServersRequestParameters < Internal::Types::Model
+        field :q, -> { String }, optional: true, nullable: false
+
+        field :parser, -> { Auth0::Types::SearchParserEnum }, optional: true, nullable: false
+
+        field :fields, -> { String }, optional: true, nullable: false
+
+        field :include_fields, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+        field :take, -> { Integer }, optional: true, nullable: false
+
+        field :from, -> { String }, optional: true, nullable: false
+
+        field :sort, -> { Auth0::Types::ResourceServerSortFieldEnum }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/auth0/resource_servers/types/update_resource_server_request_content.rb

@@ -24,10 +24,14 @@ module Auth0
 
         field :token_lifetime, -> { Integer }, optional: true, nullable: false
 
+        field :token_lifetime_for_anonymous_access_tokens, -> { Integer }, optional: true, nullable: false
+
         field :token_dialect, -> { Auth0::Types::ResourceServerTokenDialectSchemaEnum }, optional: true, nullable: false
 
         field :enforce_policies, -> { Internal::Types::Boolean }, optional: true, nullable: false
 
+        field :access_token, -> { Auth0::Types::ResourceServerAccessToken }, optional: true, nullable: false
+
         field :token_encryption, -> { Auth0::Types::ResourceServerTokenEncryption }, optional: true, nullable: false
 
         field :consent_policy, -> { Auth0::Types::ResourceServerConsentPolicyEnum }, optional: true, nullable: false

data/lib/auth0/risk_assessments/settings/client.rb

@@ -21,6 +21,9 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.risk_assessments.settings.get
+        #
         # @return [Auth0::Types::GetRiskAssessmentsSettingsResponseContent]
         def get(request_options: {}, **_params)
           request = Auth0::Internal::JSON::Request.new(
@@ -36,7 +39,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::GetRiskAssessmentsSettingsResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetRiskAssessmentsSettingsResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -53,6 +56,9 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.risk_assessments.settings.update(enabled: true)
+        #
         # @return [Auth0::Types::UpdateRiskAssessmentsSettingsResponseContent]
         def update(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -70,7 +76,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::UpdateRiskAssessmentsSettingsResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::UpdateRiskAssessmentsSettingsResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

data/lib/auth0/risk_assessments/settings/new_device/client.rb

@@ -22,6 +22,9 @@ module Auth0
           # @option request_options [Hash{String => Object}] :additional_body_parameters
           # @option request_options [Integer] :timeout_in_seconds
           #
+          # @example
+          #   client.risk_assessments.settings.new_device.get
+          #
           # @return [Auth0::Types::GetRiskAssessmentsSettingsNewDeviceResponseContent]
           def get(request_options: {}, **_params)
             request = Auth0::Internal::JSON::Request.new(
@@ -37,7 +40,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              Auth0::Types::GetRiskAssessmentsSettingsNewDeviceResponseContent.load(response.body)
+              (response.body.to_s.empty? ? nil : Auth0::Types::GetRiskAssessmentsSettingsNewDeviceResponseContent.load(response.body))
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
               raise error_class.new(response.body, code: code)
@@ -54,6 +57,9 @@ module Auth0
           # @option request_options [Hash{String => Object}] :additional_body_parameters
           # @option request_options [Integer] :timeout_in_seconds
           #
+          # @example
+          #   client.risk_assessments.settings.new_device.update(remember_for: 1)
+          #
           # @return [Auth0::Types::UpdateRiskAssessmentsSettingsNewDeviceResponseContent]
           def update(request_options: {}, **params)
             params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -71,7 +77,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              Auth0::Types::UpdateRiskAssessmentsSettingsNewDeviceResponseContent.load(response.body)
+              (response.body.to_s.empty? ? nil : Auth0::Types::UpdateRiskAssessmentsSettingsNewDeviceResponseContent.load(response.body))
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
               raise error_class.new(response.body, code: code)

data/lib/auth0/roles/client.rb

@@ -29,6 +29,16 @@ module Auth0
       # @option params [Auth0::Types::RoleTypeEnum, nil] :type
       # @option params [String, nil] :owner_id
       #
+      # @example
+      #   client.roles.list(
+      #     per_page: 1,
+      #     page: 1,
+      #     include_totals: true,
+      #     name_filter: "name_filter",
+      #     type: "tenant",
+      #     owner_id: "owner_id"
+      #   )
+      #
       # @return [Auth0::Types::ListRolesOffsetPaginatedResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -61,7 +71,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListRolesOffsetPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListRolesOffsetPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -83,6 +93,9 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.roles.create(name: "name")
+      #
       # @return [Auth0::Types::CreateRoleResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -100,7 +113,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateRoleResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateRoleResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -119,6 +132,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.roles.get(id: "id")
+      #
       # @return [Auth0::Types::GetRoleResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -135,7 +151,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetRoleResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetRoleResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -154,6 +170,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.roles.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -187,6 +206,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.roles.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateRoleResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -208,7 +230,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateRoleResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateRoleResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/auth0/roles/groups/client.rb

@@ -24,6 +24,13 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.roles.groups.get(
+        #     id: "id",
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListRoleGroupsResponseContent]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -51,7 +58,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListRoleGroupsResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListRoleGroupsResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -71,6 +78,12 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.roles.groups.create(
+        #     id: "id",
+        #     groups: ["groups"]
+        #   )
+        #
         # @return [untyped]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -108,6 +121,12 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.roles.groups.delete(
+        #     id: "id",
+        #     groups: ["groups"]
+        #   )
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/roles/permissions/client.rb

@@ -25,6 +25,14 @@ module Auth0
         # @option params [Integer, nil] :page
         # @option params [Boolean, nil] :include_totals
         #
+        # @example
+        #   client.roles.permissions.list(
+        #     id: "id",
+        #     per_page: 1,
+        #     page: 1,
+        #     include_totals: true
+        #   )
+        #
         # @return [Auth0::Types::ListRolePermissionsOffsetPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -54,7 +62,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListRolePermissionsOffsetPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListRolePermissionsOffsetPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -76,6 +84,15 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.roles.permissions.add(
+        #     id: "id",
+        #     permissions: [{
+        #       resource_server_identifier: "resource_server_identifier",
+        #       permission_name: "permission_name"
+        #     }]
+        #   )
+        #
         # @return [untyped]
         def add(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -115,6 +132,15 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.roles.permissions.delete(
+        #     id: "id",
+        #     permissions: [{
+        #       resource_server_identifier: "resource_server_identifier",
+        #       permission_name: "permission_name"
+        #     }]
+        #   )
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/roles/users/client.rb

@@ -48,6 +48,14 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.roles.users.list(
+        #     id: "id",
+        #     include_totals: true,
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListRoleUsersPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -76,7 +84,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListRoleUsersPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListRoleUsersPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -99,6 +107,12 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.roles.users.assign(
+        #     id: "id",
+        #     users: ["users"]
+        #   )
+        #
         # @return [untyped]
         def assign(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/rules/client.rb

@@ -27,6 +27,16 @@ module Auth0
       # @option params [String, nil] :fields
       # @option params [Boolean, nil] :include_fields
       #
+      # @example
+      #   client.rules.list(
+      #     page: 1,
+      #     per_page: 1,
+      #     include_totals: true,
+      #     enabled: true,
+      #     fields: "fields",
+      #     include_fields: true
+      #   )
+      #
       # @return [Auth0::Types::ListRulesOffsetPaginatedResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -59,7 +69,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListRulesOffsetPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListRulesOffsetPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -81,6 +91,12 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.rules.create(
+      #     name: "name",
+      #     script: "script"
+      #   )
+      #
       # @return [Auth0::Types::CreateRuleResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -98,7 +114,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateRuleResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateRuleResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -119,6 +135,13 @@ module Auth0
       # @option params [String, nil] :fields
       # @option params [Boolean, nil] :include_fields
       #
+      # @example
+      #   client.rules.get(
+      #     id: "id",
+      #     fields: "fields",
+      #     include_fields: true
+      #   )
+      #
       # @return [Auth0::Types::GetRuleResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -140,7 +163,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetRuleResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetRuleResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -158,6 +181,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.rules.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -190,6 +216,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.rules.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateRuleResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -211,7 +240,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateRuleResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateRuleResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)