Remove TOTP device

Removes a totp device

POST/{apiBasePath}/totp/device/remove

Authorization

AuthorizationBearer token · headerrequired

Returned as the "st-access-token" header from sign-in and refresh endpoints and present on requests that update the access token payload

sAccessTokenAPI key · cookierequired

This is an HTTPOnly cookie, set by sign-in and refresh endpoints and present on requests that update the access token

Path parameters

apiBasePathstringrequired

Its value depends on the apiBasePath set by the user

Header parameters

ridstring

The TOTP recipe ID

anti-csrftoken

This will only be here if enabled by the user.

Request body

application/json

deviceNamestring

Responses

200Success report

One of:

object

statusstatusOK

Success status indicator

Allowed:OK

didDeviceExistboolean

generalErrorResponse

statusstring

Error status code

Allowed:GENERAL_ERROR

messagestring

Error message

404Resource not found error

string

500Internal server error

string

Try it

Server

Custom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

apiBasePathpath*Its value depends on the apiBasePath set by the userridheaderThe TOTP recipe IDanti-csrfheaderThis will only be here if enabled by the user.

Bodyapplication/json

deviceNamestring

Request

curl -X POST "/auth/totp/device/remove" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "deviceName": "asdf123"
}'

const response = await fetch("/auth/totp/device/remove", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "deviceName": "asdf123"
})
});

import requests

response = requests.post(
    "/auth/totp/device/remove",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "deviceName": "asdf123"
},
)

Response

{
  "status": "OK",
  "didDeviceExist": true
}

"Not Found"

"Internal Error"