Documentation Index

Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt

Use this file to discover all available pages before exploring further.

Disable TOTP 2FA

Prev Next
Post
/api/v1/users.disableTotp

Disables the authenticator app (TOTP) two-factor authentication of your own account. The code from the authenticator app is required in the body. Requests are limited to five per minute.

This endpoint replaces the deprecated 2fa:disable real-time method, which remains available until 9.0.0.

Changelog

Version Description
8.8.0 Added
Header parameters
X-Auth-Token
stringRequired

The authToken of the authenticated user.

X-User-Id
stringRequired

The userId of the authenticated user.

Body parameters
Example 1
{
  "code": "482913"
}
object
code
string Required

The code shown by the authenticator app for the account.

Example482913
Responses
200

OK

Success Example
{
  "disabled": true,
  "success": true
}
object
disabled
boolean
success
boolean
400

Bad Request

object
success
boolean
error
string
errorType
string
401

Unauthorized

Authorization Error
{
  "status": "error",
  "message": "You must be logged in to do this."
}
object
status
string
message
string