Skip to content

Turn off two-factor authentication

DELETE
/account/security/2fa

Turns off two-factor authentication, so signing in needs only your password again. Send your current password; a wrong one, or an account with no password of its own, gets a 400.

If two-factor authentication wasn’t set up, you still get 204. Your recovery codes aren’t deleted, but they stop working because nothing asks for a second factor any more. Setting up and confirming two-factor authentication again replaces them.

Your sessions and API tokens stay signed in, and turning it off isn’t recorded in the audit log. An API token works here as well as the session cookie.

Your current password. It’s asked for again so that someone using your session can’t make this change without it.

object
current_password
required
string format: password

Two-factor authentication is off.

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}