Forget one remembered device

DELETE

/v1/auth/mfa/trusted-devices/{id}

Forgets one remembered device by id, so that browser is challenged on its next sign-in, and returns 204 No Content. Responds 404 when the device does not exist or belongs to someone else.

Authentication

Bearer TokenAuthorization

JWT access token. Never send alongside X-API-Key: a request carrying both is refused.

Path Parameters

idstring Required

Responses

Deletes the row; the device's cookie is refused on its next sign-in.

application/json

errorApiErrorBodyDto*

application/json

errorApiErrorBodyDto*

application/json

errorApiErrorBodyDto*

application/json

errorApiErrorBodyDto*

Request

curl -X DELETE "https://auth.canopy-io.com/v1/auth/mfa/trusted-devices/value" \
  -H "Authorization: Bearer $CANOPY_TOKEN"

Response

HTTP/1.1 204 Deletes the row; the device's cookie is refused on its next sign-in.

(empty body)

GETList the caller's enrolled second factors
POSTBegin authenticator app enrollment
POSTComplete authenticator app enrollment
POSTBegin passkey enrollment
POSTComplete passkey enrollment
POSTProve a fresh second factor before a sensitive change
POSTBegin a passkey step-up
POSTComplete a passkey step-up
DELETERemove one of the caller's second factors
GETHow many recovery codes the caller has left
POSTRegenerate the caller's recovery codes
GETList the caller's remembered devices
DELETEForget every remembered device

Was this page helpful?

Tell us how we can improve this guide.