Turn the authenticator off

POST

/v1/auth/totp/disable

const url = 'http://localhost:8080/v1/auth/totp/disable';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"code":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url http://localhost:8080/v1/auth/totp/disable \
  --header 'Content-Type: application/json' \
  --data '{ "code": "example" }'

Requires a fresh code from the app; a lost device is handled by an administrator reset (DELETE /v1/users/{id}/totp), never by this call. 401 for a wrong code, 409 when no authenticator is active.

Request Body^required

application/json

Disabling needs a fresh code; losing the device is handled by an admin reset, not by this call.

object

code

string

Example^generated

{
  "code": "example"
}

Responses

204

No Content

Turn the authenticator off

Request Bodyrequired

Examplegenerated

Responses

204

Request Body^required

Example^generated