auth0 6.1.0 → 6.3.0

data/lib/auth0/users/client.rb

@@ -51,6 +51,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 +101,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 +124,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 +144,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 +171,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 +199,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 +222,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 +250,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 +269,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 +400,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 +424,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 +445,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 +464,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 +482,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

@@ -14,6 +14,24 @@ module Auth0
         # Retrieve list of the specified user's current Organization memberships. User must be specified by user ID. For
         # more information, review [Auth0 Organizations](https://auth0.com/docs/manage-users/organizations).
         #
+        # This endpoint supports two types of pagination:
+        #
+        # - Offset pagination
+        # - Checkpoint pagination
+        #
+        # Checkpoint pagination must be used if you need to retrieve more than 1000 organizations.
+        #
+        # **Checkpoint Pagination**
+        #
+        # To search by checkpoint, use the following parameters:
+        #
+        # - `from`: Optional id from which to start selection.
+        # - `take`: The total number of entries to retrieve when using the `from` parameter. Defaults to 50.
+        #
+        # **Note**: The first time you call this endpoint using checkpoint pagination, omit the `from` parameter. If
+        # there are more results, a `next` value is included in the response. You can use this for subsequent API calls.
+        # When `next` is no longer included in the response, no pages are remaining.
+        #
         # @param request_options [Hash]
         # @param params [Hash]
         # @option request_options [String] :base_url
@@ -26,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)
@@ -55,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)

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

@@ -28,6 +28,14 @@ module Auth0
         # @option params [Integer, nil] :page
         # @option params [Boolean, nil] :include_totals
         #
+        # @example
+        #   client.users.permissions.list(
+        #     id: "id",
+        #     per_page: 1,
+        #     page: 1,
+        #     include_totals: true
+        #   )
+        #
         # @return [Auth0::Types::ListUserPermissionsOffsetPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -57,7 +65,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListUserPermissionsOffsetPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserPermissionsOffsetPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -77,6 +85,15 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.permissions.create(
+        #     id: "id",
+        #     permissions: [{
+        #       resource_server_identifier: "resource_server_identifier",
+        #       permission_name: "permission_name"
+        #     }]
+        #   )
+        #
         # @return [untyped]
         def create(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -114,6 +131,15 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.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/users/refresh_token/client.rb

@@ -25,6 +25,14 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.users.refresh_token.list(
+        #     user_id: "user_id",
+        #     include_totals: true,
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListRefreshTokensPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -53,7 +61,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListRefreshTokensPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListRefreshTokensPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -73,6 +81,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :user_id
         #
+        # @example
+        #   client.users.refresh_token.delete(user_id: "user_id")
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

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

@@ -22,6 +22,13 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.risk_assessments.clear(
+        #     id: "id",
+        #     connection: "connection",
+        #     assessors: ["new-device"]
+        #   )
+        #
         # @return [untyped]
         def clear(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

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

@@ -32,6 +32,14 @@ module Auth0
         # @option params [Integer, nil] :page
         # @option params [Boolean, nil] :include_totals
         #
+        # @example
+        #   client.users.roles.list(
+        #     id: "id",
+        #     per_page: 1,
+        #     page: 1,
+        #     include_totals: true
+        #   )
+        #
         # @return [Auth0::Types::ListUserRolesOffsetPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -61,7 +69,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListUserRolesOffsetPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserRolesOffsetPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -87,6 +95,12 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.roles.assign(
+        #     id: "id",
+        #     roles: ["roles"]
+        #   )
+        #
         # @return [untyped]
         def assign(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -129,6 +143,12 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :id
         #
+        # @example
+        #   client.users.roles.delete(
+        #     id: "id",
+        #     roles: ["roles"]
+        #   )
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)

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

@@ -25,6 +25,14 @@ module Auth0
         # @option params [String, nil] :from
         # @option params [Integer, nil] :take
         #
+        # @example
+        #   client.users.sessions.list(
+        #     user_id: "user_id",
+        #     include_totals: true,
+        #     from: "from",
+        #     take: 1
+        #   )
+        #
         # @return [Auth0::Types::ListUserSessionsPaginatedResponseContent]
         def list(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)
@@ -53,7 +61,7 @@ module Auth0
             end
             code = response.code.to_i
             if code.between?(200, 299)
-              parsed_response = Auth0::Types::ListUserSessionsPaginatedResponseContent.load(response.body)
+              parsed_response = (response.body.to_s.empty? ? nil : Auth0::Types::ListUserSessionsPaginatedResponseContent.load(response.body))
               [parsed_response, response]
             else
               error_class = Auth0::Errors::ResponseError.subclass_for_code(code)
@@ -73,6 +81,9 @@ module Auth0
         # @option request_options [Integer] :timeout_in_seconds
         # @option params [String] :user_id
         #
+        # @example
+        #   client.users.sessions.delete(user_id: "user_id")
+        #
         # @return [untyped]
         def delete(request_options: {}, **params)
           params = Auth0::Internal::Types::Utils.normalize_keys(params)