<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[How can I disable MFA for a locked-out admin user in FusionAuth?]]></title><description><![CDATA[<p dir="auto">An admin user in our FusionAuth instance has MFA enabled but cannot complete the MFA challenge (lost device, cannot receive codes, etc.). This has locked them out of their account. We need to disable MFA for this user to restore access. What options are available to resolve this situation?</p>
]]></description><link>https://fusionauth.io/community/forum/topic/3414/how-can-i-disable-mfa-for-a-locked-out-admin-user-in-fusionauth</link><generator>RSS for Node</generator><lastBuildDate>Sat, 21 Nov 2026 09:45:28 GMT</lastBuildDate><atom:link href="https://fusionauth.io/community/forum/topic/3414.rss" rel="self" type="application/rss+xml"/><pubDate>Thu, 19 Nov 2026 18:36:15 GMT</pubDate><ttl>60</ttl><item><title><![CDATA[Reply to How can I disable MFA for a locked-out admin user in FusionAuth? on Thu, 19 Nov 2026 18:36:26 GMT]]></title><description><![CDATA[<p dir="auto">If an admin user is locked out due to MFA, you have several options:</p>
<ol>
<li>
<p dir="auto"><strong>Use Recovery Codes (if available)</strong>: If the user previously generated recovery codes, they can use one of those codes to complete the MFA challenge and regain access. Once logged in, they can disable or reconfigure MFA.</p>
</li>
<li>
<p dir="auto"><strong>Generate Recovery Codes via API</strong>: Another admin with API access can generate recovery codes for the locked-out user using the Generate Recovery Codes API endpoint:</p>
</li>
</ol>
<pre><code>POST /api/user/two-factor/recovery-code/{userId}
</code></pre>
<p dir="auto">Replace <code>{userId}</code> with the locked-out user's ID. This will generate new recovery codes that can be shared with the user to complete their MFA challenge.</p>
<ol start="3">
<li>
<p dir="auto"><strong>Have Another Admin Disable MFA</strong>: If you have another admin user with access to the FusionAuth admin UI, they can navigate to the locked-out user's account and disable MFA directly from the user management interface. Users with the <code>admin</code> role can remove MFA methods from any user without requiring a one-time verification code. Navigate to <strong>Users → Manage User → Multi-Factor tab</strong>, click the red trash can icon next to the MFA method, and confirm the removal.</p>
</li>
<li>
<p dir="auto"><strong>Use the User API to Remove MFA</strong>: An admin with API access can also remove MFA methods by updating the user object directly. Retrieve the user via the User API, remove the methods from the <code>twoFactor</code> array, and then <code>PUT</code> the updated user back. Note that you must use <code>PUT</code> (not <code>PATCH</code>) due to how array handling works:</p>
</li>
</ol>
<pre><code class="language-bash"># Retrieve the user
curl -XGET -H "Authorization: $API_KEY" \
  'https://your-fusionauth-url/api/user/{userId}'

# Remove the twoFactor array entries and PUT the user back
curl -XPUT -H 'Content-type: application/json' \
  -H "Authorization: $API_KEY" \
  'https://your-fusionauth-url/api/user/{userId}' \
  -d '{user object with twoFactor array cleared}'
</code></pre>
<p dir="auto"><strong>Important Note</strong>: The standard Disable Multi-Factor API (<code>DELETE /api/user/two-factor/{userId}</code>) is <strong>not suitable</strong> for this situation, as it requires a valid verification code or recovery code from the user to complete the request. This API is designed for users who can still authenticate.</p>
<p dir="auto">These approaches allow you to restore access without losing the security benefits of MFA for other users.</p>
<h2>Related Documentation</h2>
<ul>
<li><a href="https://fusionauth.io/docs/authentication/multi-factor-authentication/#disable-mfa-on-a-user" rel="nofollow ugc">Multi-Factor Authentication (MFA) - Disable MFA on a User</a></li>
<li><a href="https://fusionauth.io/docs/apis/two-factor/generate-recovery-codes" rel="nofollow ugc">Generate Recovery Codes API</a></li>
<li><a href="https://fusionauth.io/docs/apis/two-factor/retrieve-recovery-codes" rel="nofollow ugc">Retrieve Recovery Codes API</a></li>
<li><a href="https://fusionauth.io/docs/authentication/multi-factor-authentication/#recovery-codes" rel="nofollow ugc">Recovery Codes Overview</a></li>
<li><a href="https://fusionauth.io/docs/apis/two-factor/disable-multi-factor" rel="nofollow ugc">Disable Multi-Factor API</a> (requires verification code - not suitable for locked-out users)</li>
<li><a href="https://fusionauth.io/docs/concepts/types/roles#the-mfa_deleter-role" rel="nofollow ugc">The mfa_deleter Role</a> (for support teams with restricted permissions)</li>
<li><a href="https://fusionauth.io/docs/users/user-support-guide#remove-an-mfa-method-with-the-mfa_deleter-role" rel="nofollow ugc">User Support Guide - Remove an MFA Method</a></li>
</ul>
]]></description><link>https://fusionauth.io/community/forum/post/9169</link><guid isPermaLink="true">https://fusionauth.io/community/forum/post/9169</guid><dc:creator><![CDATA[FASupportBot]]></dc:creator><pubDate>Thu, 19 Nov 2026 18:36:26 GMT</pubDate></item></channel></rss>