auth0 6.2.0 → 6.4.0

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

@@ -25,6 +25,14 @@ module Auth0
         # @option params [Integer, nil] :per_page
         # @option params [Boolean, nil] :include_totals
         #
+        # @example
+        #   client.users.authentication_methods.list(
+        #     id: "id",
+        #     page: 1,
+        #     per_page: 1,
+        #     include_totals: true
+        #   )
+        #
         # @return [Auth0::Types::ListUserAuthenticationMethodsOffsetPaginatedResponseContent]
         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::ListUserAuthenticationMethodsOffsetPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserAuthenticationMethodsOffsetPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -75,6 +83,12 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.authentication_methods.create(
+        #     id: "id",
+        #     type: "phone"
+        #   )
+        #
         # @return [Auth0::Types::CreateUserAuthenticationMethodResponseContent]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -96,7 +110,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::CreateUserAuthenticationMethodResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::CreateUserAuthenticationMethodResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -119,14 +133,25 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.authentication_methods.set(
+        #     id: "id",
+        #     request: [{
+        #       type: "phone"
+        #     }]
+        #   )
+        #
         # @return [Array[Auth0::Types::SetUserAuthenticationMethodResponseContent]]
         def set(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: "PUT",
             path: "users/#{URI.encode_uri_component(params[:id].to_s)}/authentication-methods",
-            body: params,
+            body: body_params,
             request_options: request_options
           )
           begin
@@ -135,10 +160,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::SetUserAuthenticationMethodResponseContent], (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
 
         # Remove all authentication methods (i.e., enrolled MFA factors) from the specified user account. This action
@@ -153,6 +180,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.authentication_methods.delete_all(id: "id")
+        #
         # @return [untyped]
         def delete_all(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -184,6 +214,12 @@ module Auth0
         # @option params [String] :id
         # @option params [String] :authentication_method_id
         #
+        # @example
+        #   client.users.authentication_methods.get(
+        #     id: "id",
+        #     authentication_method_id: "authentication_method_id"
+        #   )
+        #
         # @return [Auth0::Types::GetUserAuthenticationMethodResponseContent]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -200,7 +236,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::GetUserAuthenticationMethodResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::GetUserAuthenticationMethodResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)
@@ -221,6 +257,12 @@ module Auth0
         # @option params [String] :id
         # @option params [String] :authentication_method_id
         #
+        # @example
+        #   client.users.authentication_methods.delete(
+        #     id: "id",
+        #     authentication_method_id: "authentication_method_id"
+        #   )
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -256,6 +298,12 @@ module Auth0
         # @option params [String] :id
         # @option params [String] :authentication_method_id
         #
+        # @example
+        #   client.users.authentication_methods.update(
+        #     id: "id",
+        #     authentication_method_id: "authentication_method_id"
+        #   )
+        #
         # @return [Auth0::Types::UpdateUserAuthenticationMethodResponseContent]
         def update(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -277,7 +325,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::UpdateUserAuthenticationMethodResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::UpdateUserAuthenticationMethodResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

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

@@ -24,6 +24,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.authenticators.delete_all(id: "id")
+        #
         # @return [untyped]
         def delete_all(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

data/lib/auth0/users/client.rb

@@ -10,28 +10,35 @@ module Auth0
         @client = client
       end
 
-      # Retrieve details of users. It is possible to:
+      # This endpoint retrieves details of users. It's best suited to interactive, best-effort search and lookups where
+      # slightly stale results are acceptable. With it, you can:
       #
-      # - Specify a search criteria for users
+      # - Specify search criteria for users
       # - Sort the users to be returned
       # - Select the fields to be returned
       # - Specify the number of users to retrieve per page and the page index
       #
+      # This endpoint is **not suited for use in critical paths**. It is eventually consistent and runs under a short
+      # (~2 second) query time limit, so results can be stale and heavy queries can return a 503.
       #
+      # - Do not use this endpoint for authentication, account linking, or logic inside login-flow Actions. Instead,
+      # [look users up directly by ID or
+      # email](https://auth0.com/docs/manage-users/user-search/get-users-by-id-or-email#management-api) to get their
+      # current state.
+      # - Do not use this endpoint to keep an external system in sync with user data. Instead, subscribe to [Event
+      # Streams](https://auth0.com/docs/customize/events/sync-data-across-systems) to receive every change as it
+      # happens.
+      # - Do not use this endpoint to enumerate or export your entire user base. Instead, run a [bulk user
+      # export](https://auth0.com/docs/manage-users/user-migration/bulk-user-exports) to retrieve the full set.
       #
-      # The `q` query parameter can be used to get users that match the specified criteria [using query string
-      # syntax.](https://auth0.com/docs/users/search/v3/query-syntax)
+      # Use the `q` query parameter to match users with [query string
+      # syntax](https://auth0.com/docs/manage-users/user-search/user-search-query-syntax). For full instructions and
+      # guidance, see [How to List and Search
+      # Users](https://auth0.com/docs/manage-users/user-search/list-and-search-users).
       #
-      # [Learn more about searching for users.](https://auth0.com/docs/users/search/v3)
-      #
-      # Read about [best practices](https://auth0.com/docs/users/search/best-practices) when working with the API
-      # endpoints for retrieving users.
-      #
-      #
-      #
-      # Auth0 limits the number of users you can return. If you exceed this threshold, please redefine your search, use
-      # the [export job](https://auth0.com/docs/api/management/v2#!/Jobs/post_users_exports), or the [User Import /
-      # Export](https://auth0.com/docs/extensions/user-import-export) extension.
+      # For efficient queries, prefer indexed top-level fields and exact matches. Certain kinds of queries can be slow
+      # and may time out, such as filtering on freeform or multi-value fields (like user-defined attributes in
+      # `app_metadata` or `user_metadata`) or using leading wildcards.
       #
       # @param request_options [Hash]
       # @param params [Hash]
@@ -51,6 +58,20 @@ module Auth0
       # @option params [Auth0::Types::SearchEngineVersionsEnum, nil] :search_engine
       # @option params [Boolean, nil] :primary_order
       #
+      # @example
+      #   client.users.list(
+      #     page: 1,
+      #     per_page: 1,
+      #     include_totals: true,
+      #     sort: "sort",
+      #     connection: "connection",
+      #     fields: "fields",
+      #     include_fields: true,
+      #     q: "q",
+      #     search_engine: "v1",
+      #     primary_order: true
+      #   )
+      #
       # @return [Auth0::Types::ListUsersOffsetPaginatedResponseContent]
       def list(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -87,7 +108,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            parsed_response = Auth0::Types::ListUsersOffsetPaginatedResponseContent.load(response.body)
+            parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUsersOffsetPaginatedResponseContent.load(response.body))
             [parsed_response, response]
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -110,6 +131,9 @@ module Auth0
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.users.create(connection: "connection")
+      #
       # @return [Auth0::Types::CreateUserResponseContent]
       def create(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -127,7 +151,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::CreateUserResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::CreateUserResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -154,6 +178,13 @@ module Auth0
       # @option params [Boolean, nil] :include_fields
       # @option params [String] :email
       #
+      # @example
+      #   client.users.list_users_by_email(
+      #     fields: "fields",
+      #     include_fields: true,
+      #     email: "email"
+      #   )
+      #
       # @return [Array[Auth0::Types::UserResponseSchema]]
       def list_users_by_email(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -175,10 +206,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::UserResponseSchema], (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
 
       # Retrieve user details. A list of fields to include or exclude may also be specified. For more information, see
@@ -196,6 +229,13 @@ module Auth0
       # @option params [String, nil] :fields
       # @option params [Boolean, nil] :include_fields
       #
+      # @example
+      #   client.users.get(
+      #     id: "id",
+      #     fields: "fields",
+      #     include_fields: true
+      #   )
+      #
       # @return [Auth0::Types::GetUserResponseContent]
       def get(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -217,7 +257,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::GetUserResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::GetUserResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -236,6 +276,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.users.delete(id: "id")
+      #
       # @return [untyped]
       def delete(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -364,6 +407,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.users.update(id: "id")
+      #
       # @return [Auth0::Types::UpdateUserResponseContent]
       def update(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -385,7 +431,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::UpdateUserResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::UpdateUserResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -406,6 +452,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.users.regenerate_recovery_code(id: "id")
+      #
       # @return [Auth0::Types::RegenerateUsersRecoveryCodeResponseContent]
       def regenerate_recovery_code(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -422,7 +471,7 @@ module Auth0
         end
         code = response.code.to_i
         if code.between?(200, 299)
-          Auth0::Types::RegenerateUsersRecoveryCodeResponseContent.load(response.body)
+          (response.body.to_s.empty? ? nil : Auth0::Types::RegenerateUsersRecoveryCodeResponseContent.load(response.body))
         else
           error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
           raise error_class.new(response.body, code: code)
@@ -440,6 +489,9 @@ module Auth0
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :id
       #
+      # @example
+      #   client.users.revoke_access(id: "id")
+      #
       # @return [untyped]
       def revoke_access(request_options: {}, **params)
         params = Auth0::Internal::Types::Utils.normalize_keys(params)

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

@@ -24,6 +24,13 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.users.connected_accounts.list(
+        #     id: "id",
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListUserConnectedAccountsResponseContent]
         def list(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::ListUserConnectedAccountsResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserConnectedAccountsResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)

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

@@ -26,6 +26,14 @@ module Auth0
         # @option params [Integer, nil] :take
         # @option params [String] :resource_server_identifier
         #
+        # @example
+        #   client.users.effective_permissions.list(
+        #     id: "id",
+        #     from: "from",
+        #     take: 1,
+        #     resource_server_identifier: "resource_server_identifier"
+        #   )
+        #
         # @return [Auth0::Types::ListUserEffectivePermissionsResponseContent]
         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::ListUserEffectivePermissionsResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserEffectivePermissionsResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)

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

@@ -29,6 +29,15 @@ module Auth0
             # @option params [String] :resource_server_identifier
             # @option params [String] :permission_name
             #
+            # @example
+            #   client.users.effective_permissions.sources.roles.list(
+            #     id: "id",
+            #     from: "from",
+            #     take: 1,
+            #     resource_server_identifier: "resource_server_identifier",
+            #     permission_name: "permission_name"
+            #   )
+            #
             # @return [Auth0::Types::ListUserEffectivePermissionRoleSourcesResponseContent]
             def list(request_options: {}, **params)
               params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -58,7 +67,7 @@ module Auth0
                 end
                 code = response.code.to_i
                 if code.between?(200, 299)
-                  parsed_response = Auth0::Types::ListUserEffectivePermissionRoleSourcesResponseContent.load(response.body)
+                  parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserEffectivePermissionRoleSourcesResponseContent.load(response.body))
                   [parsed_response, response]
                 else
                   error_class = Auth0::Errors::ResponseError.subclass_for_code(code)

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

@@ -25,6 +25,13 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.users.effective_roles.list(
+        #     id: "id",
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListUserEffectiveRolesResponseContent]
         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::ListUserEffectiveRolesResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserEffectiveRolesResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)

data/lib/auth0/users/effective_roles/sources/groups/client.rb

@@ -27,6 +27,14 @@ module Auth0
             # @option params [String, nil] :from
             # @option params [Integer, nil] :take
             #
+            # @example
+            #   client.users.effective_roles.sources.groups.list(
+            #     id: "id",
+            #     role_id: "role_id",
+            #     from: "from",
+            #     take: 1
+            #   )
+            #
             # @return [Auth0::Types::ListUserRoleSourceGroupsResponseContent]
             def list(request_options: {}, **params)
               params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -55,7 +63,7 @@ module Auth0
                 end
                 code = response.code.to_i
                 if code.between?(200, 299)
-                  parsed_response = Auth0::Types::ListUserRoleSourceGroupsResponseContent.load(response.body)
+                  parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserRoleSourceGroupsResponseContent.load(response.body))
                   [parsed_response, response]
                 else
                   error_class = Auth0::Errors::ResponseError.subclass_for_code(code)

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

@@ -24,6 +24,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.enrollments.get(id: "id")
+        #
         # @return [Array[Auth0::Types::UsersEnrollment]]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -39,10 +42,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::UsersEnrollment], (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
       end
     end

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

@@ -27,6 +27,16 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.users.groups.get(
+        #     id: "id",
+        #     fields: "fields",
+        #     include_fields: true,
+        #     include_totals: true,
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::GetUserGroupsPaginatedResponseContent]
         def get(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -57,7 +67,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::GetUserGroupsPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::GetUserGroupsPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)

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

@@ -55,6 +55,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.identities.link(id: "id")
+        #
         # @return [Array[Auth0::Types::UserIdentity]]
         def link(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -75,10 +78,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::UserIdentity], (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
 
         # Unlink a specific secondary account from a target user. This action requires the ID of both the target user
@@ -99,6 +104,13 @@ module Auth0
         # @option params [Auth0::Types::UserIdentityProviderEnum] :provider
         # @option params [String] :user_id
         #
+        # @example
+        #   client.users.identities.delete(
+        #     id: "id",
+        #     provider: "ad",
+        #     user_id: "user_id"
+        #   )
+        #
         # @return [Array[Auth0::Types::DeleteUserIdentityResponseContentItem]]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -115,7 +127,7 @@ module Auth0
           end
           code = response.code.to_i
           if code.between?(200, 299)
-            Auth0::Types::DeleteUserIdentityResponseContent.load(response.body)
+            (response.body.to_s.empty? ? nil : Auth0::Types::DeleteUserIdentityResponseContent.load(response.body))
           else
             error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
             raise error_class.new(response.body, code: code)

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

@@ -36,6 +36,15 @@ module Auth0
         # @option params [String, nil] :sort
         # @option params [Boolean, nil] :include_totals
         #
+        # @example
+        #   client.users.logs.list(
+        #     id: "id",
+        #     page: 1,
+        #     per_page: 1,
+        #     sort: "sort",
+        #     include_totals: true
+        #   )
+        #
         # @return [Auth0::Types::UserListLogOffsetPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -66,7 +75,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::UserListLogOffsetPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::UserListLogOffsetPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)

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

@@ -23,6 +23,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.multifactor.invalidate_remember_browser(id: "id")
+        #
         # @return [untyped]
         def invalidate_remember_browser(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -57,6 +60,12 @@ module Auth0
         # @option params [String] :id
         # @option params [Auth0::Types::UserMultifactorProviderEnum] :provider
         #
+        # @example
+        #   client.users.multifactor.delete_provider(
+        #     id: "id",
+        #     provider: "duo"
+        #   )
+        #
         # @return [untyped]
         def delete_provider(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

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

@@ -44,6 +44,14 @@ module Auth0
         # @option params [Integer, nil] :per_page
         # @option params [Boolean, nil] :include_totals
         #
+        # @example
+        #   client.users.organizations.list(
+        #     id: "id",
+        #     page: 1,
+        #     per_page: 1,
+        #     include_totals: true
+        #   )
+        #
         # @return [Auth0::Types::ListUserOrganizationsOffsetPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -73,7 +81,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListUserOrganizationsOffsetPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserOrganizationsOffsetPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)