# Delete MFA Method

`DELETE /gate/mfa/methods/{methodId}` · Identity & Access · Sign-in & Sessions

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

| Name | In | Required | Description |
|---|---|---|---|
| `methodId` | path | yes | The authenticator's id (`eumf_...`), as the method list returns it. Example: `"eumf_9Lp2Xc7Nb4Ts"`. |
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `code` | string | no | 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

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes | Whether an authenticator was removed. |
| `data.deleted` | boolean | yes | True when the authenticator was removed. False when the end user has no authenticator with this id. |
| `meta` | object | yes | Request metadata: cost, timing and the request and trace ids. |


## Errors

| HTTP | Code | When |
|---|---|---|
| 401 | `K9O_SESSION_EXPIRED` | Your session has expired or been revoked. Sign in again to continue. |
| 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. |
| 401 | `K9O_MFA_REQUIRED` | Removing a confirmed authenticator needs its current code. |
| 429 | `K9O_RATE_LIMITED` | Too many wrong codes for this authenticator; try again in 15 minutes. |

## Code samples

### cURL

```bash
curl -X DELETE 'https://<org>.api-<region>.k9o.io/@storefront/gate/mfa/methods/<methodId>' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/gate/mfa/methods/<methodId>', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```

### @k9o/core

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


Canonical page: https://docs.kilimanjaro.dev/api-playground/identity-access/delete-mfa-method
