Disable User

Description

This operation changes the user status to DISABLED.

This functionality can be used only in CloudCode (Java, JS or Codeless), the reason for this restriction is that a malicious use of this API can easily compromise application's security. As a result, this API must be used from a controlled environment.

Method

Blocking API

public void Backendless.UserService.disableUser( userObjectId );

Non-Blocking API

public void Backendless.UserService.disableUser( userObjectId, AsyncCallback<Void> responder );

where

Argument	Description
userObjectId	Unique identifier of the user account to be disabled. String value or number. Refer to the Data Import topic to learn more about objectId value as the number.
responder	A callback object which will receive a callback when the method successfully changes the user status. Applies to the non-blocking method only.

Return Value

None.

Example

The example below disables the user associated with the following objectId: "4D584E4D-05A3-4AC4-90C7-B80D1584E7AD".

Blocking API

String userObjectId = "4D584E4D-05A3-4AC4-90C7-B80D1584E7AD";

Backendless.UserService.disableUser( userObjectId );

Non-Blocking API

String userObjectId = "4D584E4D-05A3-4AC4-90C7-B80D1584E7AD>";

Backendless.UserService.disableUser( userObjectId, new AsyncCallback<Void>()
{
  @Override
  public void handleResponse( Void unused )
  {
    // result handling logic
  }

  @Override
  public void handleFault( BackendlessFault backendlessFault )
  {
    // error handling logic
  }
} );

Codeless Reference

where:

Argument	Description
id	objectId/unique identifier of a user account to be disabled.

Important

This Codeless block is only available in CloudCode due to the security reasons. If this operation is exposed to users, then your application can be compromised.

This operation does not return a value.

Consider the following record in the Users data table:

Note that the userStatus column contains the current user status which is ENABLED.

The example below disables the user "alice@yourmail.com" associated with the objectId: "4D584E4D-05A3-4AC4-90C7-B80D1584E7AD".

After the Codeless logic runs, the user status successfully changes to DISABLED.