Systemusers
Reset a system user's MFA token
This endpoint resets the user's TOTP key and initiates a new MFA enrollment period. The user will be prompted to set up MFA at their next login. If Unified MFA is enabled, this action will also delete the user's existing Push Notification endpoint. Warning: The user must complete the setup before the exclusionUntil date to avoid being locked out of MFA-protected resources.
Please refer to our Knowledge Base Article on setting up MFA for more information.
Sample Request
curl -X POST \
https://console.jumpcloud.com/api/systemusers/{UserID}/resetmfa \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{"exclusion": true, "exclusionUntil": "{date-time}"}'
post/api/systemusers/{id}/resetmfa
Request
- Base URLhttps://console.jumpcloud.com
- AuthAPI key in header x-api-key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Headers
x-org-idstring
Request body
Response
OK
string required
Changes
No recorded changes to this operation across all 1 revision of this API.