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

Headers

x-org-idstring

Request body

exclusionboolean
exclusionUntilstring date-time
exclusionDaysnumber

Response

OK

string required

Changes

No recorded changes to this operation across all 1 revision of this API.