auth0 6.1.0 → 6.3.0

data/lib/auth0/hooks/client.rb

@@ -27,6 +27,16 @@ module Auth0
       # @option params [String, nil] :fields
       # @option params [Auth0::Types::HookTriggerIDEnum, nil] :trigger_id
       #
+      # @example
+      #   client.hooks.list(
+      #     page: 1,
+      #     per_page: 1,
+      #     include_totals: true,
+      #     enabled: true,
+      #     fields: "fields",
+      #     trigger_id: "credentials-exchange"
+      #   )
+      #
       # @return [Auth0::Types::ListHooksOffsetPaginatedResponseContent]
       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::ListHooksOffsetPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListHooksOffsetPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -78,6 +88,13 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.hooks.create(
+      #     name: "name",
+      #     script: "script",
+      #     trigger_id: "credentials-exchange"
+      #   )
+      #
       # @return [Auth0::Types::CreateHookResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -95,7 +112,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateHookResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateHookResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -114,6 +131,12 @@ module Auth0
       # @option params [String] :id
       # @option params [String, nil] :fields
       #
+      # @example
+      #   client.hooks.get(
+      #     id: "id",
+      #     fields: "fields"
+      #   )
+      #
       # @return [Auth0::Types::GetHookResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -134,7 +157,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetHookResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetHookResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -152,6 +175,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.hooks.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -184,6 +210,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.hooks.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateHookResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -205,7 +234,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateHookResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateHookResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/auth0/hooks/secrets/client.rb

@@ -22,6 +22,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.hooks.secrets.get(id: "id")
+        #
         # @return [Hash[String, String]]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -38,7 +41,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::GetHookSecretResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetHookSecretResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -57,14 +60,25 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.hooks.secrets.create(
+        #     id: "id",
+        #     request: {
+        #       key: "value"
+        #     }
+        #   )
+        #
         # @return [untyped]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          path_param_names = %i[id]
+          body_params = params.except(*path_param_names)
+
           request = Auth0::Internal::JSON::Request.new(
             base_url: request_options[:base_url],
             method: "POST",
             path: "hooks/#{URI.encode_uri_component(params[:id].to_s)}/secrets",
-            body: params,
+            body: body_params,
             request_options: request_options
           )
           begin
@@ -90,14 +104,23 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.hooks.secrets.delete(
+        #     id: "id",
+        #     request: ["string"]
+        #   )
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          path_param_names = %i[id]
+          body_params = params.except(*path_param_names)
+
           request = Auth0::Internal::JSON::Request.new(
             base_url: request_options[:base_url],
             method: "DELETE",
             path: "hooks/#{URI.encode_uri_component(params[:id].to_s)}/secrets",
-            body: params,
+            body: body_params,
             request_options: request_options
           )
           begin
@@ -124,14 +147,25 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.hooks.secrets.update(
+        #     id: "id",
+        #     request: {
+        #       key: "value"
+        #     }
+        #   )
+        #
         # @return [untyped]
         def update(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
+          path_param_names = %i[id]
+          body_params = params.except(*path_param_names)
+
           request = Auth0::Internal::JSON::Request.new(
             base_url: request_options[:base_url],
             method: "PATCH",
             path: "hooks/#{URI.encode_uri_component(params[:id].to_s)}/secrets",
-            body: params,
+            body: body_params,
             request_options: request_options
           )
           begin

data/lib/auth0/jobs/client.rb

@@ -21,6 +21,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.jobs.get(id: "id")
+      #
       # @return [Auth0::Types::GetJobResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -37,7 +40,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetJobResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetJobResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)

data/lib/auth0/jobs/errors/client.rb

@@ -22,6 +22,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.jobs.errors.get(id: "id")
+        #
         # @return [Auth0::Jobs::Errors::Types::ErrorsGetResponse, nil]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -37,10 +40,12 @@ module Auth0
             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)
+          if code.between?(200, 299)
+            (response.body.to_s.empty? ? nil : Auth0::Jobs::Errors::Types::ErrorsGetResponse.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

data/lib/auth0/jobs/users_exports/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.jobs.users_exports.create
+        #
         # @return [Auth0::Types::CreateExportUsersResponseContent]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -38,7 +41,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::CreateExportUsersResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateExportUsersResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

data/lib/auth0/jobs/users_imports/client.rb

@@ -25,31 +25,39 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.jobs.users_imports.create
+        #
         # @return [Auth0::Types::CreateImportUsersResponseContent]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
           body = Internal::Multipart::FormData.new
 
-          body.add_part(params[:users].to_form_data_part(name: "users")) if params[:users]
-          if params[:connection_id]
+          if params[:users]
+            body.add_file(
+              name: "users",
+              file: params[:users]
+            )
+          end
+          unless params[:connection_id].nil?
             body.add(
               name: "connection_id",
               value: params[:connection_id]
             )
           end
-          if params[:upsert]
+          unless params[:upsert].nil?
             body.add(
               name: "upsert",
               value: params[:upsert]
             )
           end
-          if params[:external_id]
+          unless params[:external_id].nil?
             body.add(
               name: "external_id",
               value: params[:external_id]
             )
           end
-          if params[:send_completion_email]
+          unless params[:send_completion_email].nil?
             body.add(
               name: "send_completion_email",
               value: params[:send_completion_email]
@@ -70,7 +78,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::CreateImportUsersResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateImportUsersResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

data/lib/auth0/jobs/verification_email/client.rb

@@ -24,6 +24,9 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.jobs.verification_email.create(user_id: "user_id")
+        #
         # @return [Auth0::Types::CreateVerificationEmailResponseContent]
         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::CreateVerificationEmailResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateVerificationEmailResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

data/lib/auth0/keys/custom_signing/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.keys.custom_signing.get
+        #
         # @return [Auth0::Types::GetCustomSigningKeysResponseContent]
         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::GetCustomSigningKeysResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetCustomSigningKeysResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -53,6 +56,11 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.keys.custom_signing.set(keys: [{
+        #     kty: "EC"
+        #   }])
+        #
         # @return [Auth0::Types::SetCustomSigningKeysResponseContent]
         def set(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -70,7 +78,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::SetCustomSigningKeysResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::SetCustomSigningKeysResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -87,6 +95,9 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.keys.custom_signing.delete
+        #
         # @return [untyped]
         def delete(request_options: {}, **_params)
           request = Auth0::Internal::JSON::Request.new(

data/lib/auth0/keys/encryption/client.rb

@@ -24,6 +24,13 @@ module Auth0
         # @option params [Integer, nil] :per_page
         # @option params [Boolean, nil] :include_totals
         #
+        # @example
+        #   client.keys.encryption.list(
+        #     page: 1,
+        #     per_page: 1,
+        #     include_totals: true
+        #   )
+        #
         # @return [Auth0::Types::ListEncryptionKeyOffsetPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -53,7 +60,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListEncryptionKeyOffsetPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListEncryptionKeyOffsetPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -72,6 +79,9 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.keys.encryption.create(type: "customer-provided-root-key")
+        #
         # @return [Auth0::Types::CreateEncryptionKeyResponseContent]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -89,7 +99,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::CreateEncryptionKeyResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateEncryptionKeyResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -106,6 +116,9 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.keys.encryption.rekey
+        #
         # @return [untyped]
         def rekey(request_options: {}, **_params)
           request = Auth0::Internal::JSON::Request.new(
@@ -137,6 +150,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :kid
         #
+        # @example
+        #   client.keys.encryption.get(kid: "kid")
+        #
         # @return [Auth0::Types::GetEncryptionKeyResponseContent]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -153,7 +169,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::GetEncryptionKeyResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetEncryptionKeyResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -171,6 +187,12 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :kid
         #
+        # @example
+        #   client.keys.encryption.import(
+        #     kid: "kid",
+        #     wrapped_key: "wrapped_key"
+        #   )
+        #
         # @return [Auth0::Types::ImportEncryptionKeyResponseContent]
         def import(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -192,7 +214,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::ImportEncryptionKeyResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::ImportEncryptionKeyResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -210,6 +232,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :kid
         #
+        # @example
+        #   client.keys.encryption.delete(kid: "kid")
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -242,6 +267,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :kid
         #
+        # @example
+        #   client.keys.encryption.create_public_wrapping_key(kid: "kid")
+        #
         # @return [Auth0::Types::CreateEncryptionKeyPublicWrappingResponseContent]
         def create_public_wrapping_key(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -258,7 +286,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::CreateEncryptionKeyPublicWrappingResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateEncryptionKeyPublicWrappingResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

data/lib/auth0/keys/network_acls/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.keys.network_acls.list
+        #
         # @return [Auth0::Types::GetAllKeysNetworkACLsResponseContent]
         def list(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::GetAllKeysNetworkACLsResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetAllKeysNetworkACLsResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -54,6 +57,13 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.keys.network_acls.create(
+        #     name: "name",
+        #     alg: "hmac-sha256",
+        #     value: "value"
+        #   )
+        #
         # @return [Auth0::Types::CreateKeysNetworkACLsResponseContent]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -71,7 +81,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::CreateKeysNetworkACLsResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateKeysNetworkACLsResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -89,6 +99,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.keys.network_acls.get(id: "id")
+        #
         # @return [Auth0::Types::NetworkACLKey]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -105,7 +118,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::NetworkACLKey.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::NetworkACLKey.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -123,6 +136,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.keys.network_acls.delete(id: "id")
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/keys/signing/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.keys.signing.list
+        #
         # @return [Array[Auth0::Types::SigningKeys]]
         def list(request_options: {}, **_params)
           request = Auth0::Internal::JSON::Request.new(
@@ -35,10 +38,12 @@ module Auth0
             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)
+          if code.between?(200, 299)
+            Auth0::Internal::Types::Utils.coerce(Internal::Types::Array[Auth0::Types::SigningKeys], (response.body.to_s.empty? ? nil : JSON.parse(response.body, symbolize_names: true)))
+          else
+            error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
         end
 
         # Rotate the application signing key of your tenant.
@@ -51,6 +56,9 @@ module Auth0
         # @option request_options [Hash{String => Object}] :additional_body_parameters
         # @option request_options [Integer] :timeout_in_seconds
         #
+        # @example
+        #   client.keys.signing.rotate
+        #
         # @return [Auth0::Types::RotateSigningKeysResponseContent]
         def rotate(request_options: {}, **_params)
           request = Auth0::Internal::JSON::Request.new(
@@ -66,7 +74,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::RotateSigningKeysResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::RotateSigningKeysResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -84,6 +92,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :kid
         #
+        # @example
+        #   client.keys.signing.get(kid: "kid")
+        #
         # @return [Auth0::Types::GetSigningKeysResponseContent]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -100,7 +111,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::GetSigningKeysResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetSigningKeysResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -118,6 +129,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :kid
         #
+        # @example
+        #   client.keys.signing.revoke(kid: "kid")
+        #
         # @return [Auth0::Types::RevokedSigningKeysResponseContent]
         def revoke(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -134,7 +148,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::RevokedSigningKeysResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::RevokedSigningKeysResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)