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 ( |
| projectSlug * | path | The project's slug: the path segment after It is unique within the org. |
Request body
| code | string | A current code from the authenticator being removed. Required for a confirmed authenticator app; without it the request gets 401 Not needed for a pending one. |
Responses
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Success | |
| 401 | K9O_SESSION_EXPIRED | Your session has expired or been revoked. Sign in again to continue. |
| 401 | K9O_MFA_REQUIRED | Removing a confirmed authenticator needs its current code. |
| 403 | K9O_ACCESS_DENIED | You do not have the required role to remove this MFA method. |
| 404 | K9O_END_USER_NOT_FOUND | No account was found for the provided identity. |
| 429 | K9O_RATE_LIMITED | Too 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
}
}