Generate a new Time-based One-Time Password (TOTP) authenticator for two-factor authentication. Returns a QR code URL and manual setup key.
curl --request POST \
--url https://{deploymentHost}/me/authenticator{
"status": 200,
"message": "",
"data": {
"id": "auth_123456789",
"secret": "JBSWY3DPEHPK3PXP",
"qr_code_url": "otpauth://totp/Acme%20Corp:john.doe@example.com?secret=JBSWY3DPEHPK3PXP&issuer=Acme%20Corp",
"backup_codes": [
"1234-5678",
"2345-6789",
"3456-7890",
"4567-8901",
"5678-9012",
"6789-0123",
"7890-1234",
"8901-2345",
"9012-3456",
"0123-4567",
"1357-2468",
"2468-1357"
],
"verified": false,
"created_at": "2024-01-15T10:30:00Z"
},
"session": {
"signin_attempts": [],
"signins": [
{
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
],
"signup_attempts": [],
"active_signin": {
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
},
"errors": []
}curl --request POST \
--url https://{deploymentHost}/me/authenticator{
"status": 200,
"message": "",
"data": {
"id": "auth_123456789",
"secret": "JBSWY3DPEHPK3PXP",
"qr_code_url": "otpauth://totp/Acme%20Corp:john.doe@example.com?secret=JBSWY3DPEHPK3PXP&issuer=Acme%20Corp",
"backup_codes": [
"1234-5678",
"2345-6789",
"3456-7890",
"4567-8901",
"5678-9012",
"6789-0123",
"7890-1234",
"8901-2345",
"9012-3456",
"0123-4567",
"1357-2468",
"2468-1357"
],
"verified": false,
"created_at": "2024-01-15T10:30:00Z"
},
"session": {
"signin_attempts": [],
"signins": [
{
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
],
"signup_attempts": [],
"active_signin": {
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
},
"errors": []
}