Regenerate token

MFA token regeneration.

This API regenerates the token after successfully logging into the system using the MFA password or OTP. The key used in the request is generated from the mfa/otp/validate or mfa/password/validate API.

Using this API, you can regenerate the token without going through the primary flow.

API endpoint example



  • Validate the OTP or password in the MFA flow.

Resource information

Pagination supported?NA
Rate limitNA
Batch supportNA

Request body parameters

(Parameters marked with * are mandatory)
Data TypeDescription
deviceId*StringUnique ID of the device used for token regeneration.
brand*StringName of the brand or organisation that needs verification.
key*StringKey generated from the password/OTP validate response.
identifierType*StringType of identifier to identify the customer. Values: MOBILE, EMAIL, USERNAME, EXTERNALID
identifierValue*StringValue of the identifier.
curl --location '' \
--header 'Content-Type: application/json' \
--header 'Cookie: _cfuvid=qHEKZJZpeVmP7CCaiQVbuf_cn3J2udxCwCDepAgLl1o-1717059715288-' \
--data '{

Response parameters

statusobjectObject containing status information.
- successbooleanBoolean indicating the status of the request.
- codeintegerHTTP status code indicating the result. Example: 200 indicates success.
- messagestringMessage describing the status of the request.
authobjectObject containing authentication details.
- tokenstringString representing the authentication token. By default, the token is valid for 15 minutes.
- keystringString representing the authentication key.
userobjectObject containing user details.
- appRegisteredbooleanIndicates if the user is registered in the app.
- sessionIdstringSession ID for MFA flow. The session ID is valid for 15 minutes by default.
- rolestringIndicates the user's role. Example: VIEW, USER.
- userRegisteredForPasswordbooleanIndicates if the user is registered for a password.
    "status": {
        "success": true,
        "code": 200,
        "message": "SUCCESS"
    "auth": {
        "token": "eyJpZHYiOlsiTU9CSUxFfDE4NzY3NDMxNzU0Il0sImRldiI6IjEyMzQiLCJvcmciOiJCVUtMIiwiYWxnIjoiSFMyNTYifQ.eyJ1aWQiOiIxNzgwNzc2IiwiaXNzIjoiQ0FQSUxMQVJZIFRFQ0hOT0xPR0lFUyIsImlzYyI6ImZhbHNlIiwib2djIjpbIjEwMDQ1OHxidWtsLmluZC5zb2x1dGlvbiJdLCJleHAiOjE3MTcwNjE0NjUsImlhdCI6MTcxNzA2MDU2NSwicm9sIjoiVVNFUiJ9.rmKqmOQyYYtEPs422G0xZ-EUFpak5i0jdrx9W4YVxJQ",
        "key": null
    "user": {
        "appRegistered": false,
        "sessionId": null,
        "role": "USER",
        "userRegisteredForPassword": true
Click Try It! to start a request and see the response here!