Skip to main content
DELETE/gate/mfa/methods/{methodId}

Delete MFA Method

Removes a specific enrolled MFA factor (identified by methodId) from the end-user's account, deactivating that factor for future sign-in challenges.

Re-authentication is required.

Requires a valid end-user JWT.

Parameters
methodId *path

The authenticator's id (eumf_...), as the method list returns it.

projectSlug *path

The project's slug: the path segment after @.

It is unique within the org.

Request body
codestring

A current code from the authenticator being removed.

Required for a confirmed authenticator app; without it the request gets 401 K9O_MFA_REQUIRED.

Not needed for a pending one.

Responses
HTTPK9O CodeDescription
200Success
401K9O_SESSION_EXPIREDYour session has expired or been revoked. Sign in again to continue.
401K9O_MFA_REQUIREDRemoving a confirmed authenticator needs its current code.
403K9O_ACCESS_DENIEDYou do not have the required role to remove this MFA method.
404K9O_END_USER_NOT_FOUNDNo account was found for the provided identity.
429K9O_RATE_LIMITEDToo many wrong codes for this authenticator; try again in 15 minutes.
Response body (200)
data *object

Whether an authenticator was removed.

deleted *boolean

True when the authenticator was removed.

False when the end user has no authenticator with this id.

meta *any

Request metadata: cost, timing and the request and trace ids.

TypeScript
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.gate.mfa.methods.delete('eumf_9Lp2Xc7Nb4Ts')

Showing example in TypeScript

Request example
{
  "code": "string"
}
Response example (200)
{
  "data": {
    "deleted": false
  }
}

More in Sign-in & Sessions