Deactivate Idle Users

HTTP MethodURLRequires Auth

POST

/api/v1/users.deactivateIdle

Permission required: edit-other-user-active-status

Body Parameters

KeyExample ValueDescription

daysIdle*

2

The number of days that the user is idle.

role

admin

The user role. By default, the value is user.

The last login of the users is considered for deactivation. If no last login exists, then the date of creation is considered.

Example Call

curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     -H "Content-type:application/json" \
     http://localhost:3000/api/v1/users.deactivateIdle \
     -d '{ 
          "daysIdle": 2, 
          "role": "admin" }'

Example Response

{
  "count": 1,
  "success": true
}

Change Log

VersionDescription

3.1.0

Added

Last updated

Rocket.Chat versions receive support for six months after release.