Skip to main content
POST
Reset a user's multi-factor enrollment

Authorizations

Authorization
string
header
required

A machine-client token from POST /v1/auth/client-token. Reads need the pulse.read scope; provisioning and tenant updates need pulse.write, which the token only carries when requested_scopes asks for it. Creating, changing, disabling and resetting MFA for users, and the tenant sign-in policy, need a signed-in user's token instead: they reject API-key tokens.

Path Parameters

userId
string<uuid>
required

The user: a user_id from List users (GET /v1/msp/admin/users).

Body

application/json
reason
string
required

Why the MFA methods are being reset, kept in the audit log. Required, at most 160 characters; otherwise 400 auth_request_invalid.

Response

204

No Content