Api
Activate email OTP POST
Activate TOTP POST
Get active 2FA methods GET
Set or reset email OTP POST
Initiate email OTP challenge POST
Initiate an email address transfer POST
Set or reset TOTP POST
Time until the next email OTP may be generated GET
Send a password reset email POST
Complete an email address transfer PUT
Time until the next recovery code guess GET
Deactivate email OTP DELETE
Deactivate TOTP DELETE
Reset the recovery codes of a user POST
Send a password reset OTP POST
Time until the next TOTP guess GET
Update password via OTP PUT
Update password via sudo token PUT
Check a password reset OTP POST
Complete email OTP challenge POST
Verify a recovery code POST
Verify TOTP code POST
Sofar logo
Sofar logo
User
POST
/user/2fa/email-otp/challenge

Providing an access token, send an email OTP which can be used to acquire a sudo token

Authorization

AuthorizationBearer <token>

A valid access token (proof of identity) can be obtained via the /accesstoken endpoint. It has a 5 minutes validity period.

In: header

Query Parameters

origin?string

The mail configuration which should be used to send the email

Lengthlength <= 256
language?string

The language which should be used for sending the email

Length2 <= length <= 2

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://authentication.eniris.be/user/2fa/email-otp/challenge" \  -H "Content-Type: application/json" \  -d '{}'
null
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Invalid email address"
}
{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "NO_TOKEN_PROVIDED"
}
{
  "statusCode": 409,
  "error": "Conflict",
  "message": "EMAIL_OTP_UNINITIALIZED"
}
{
  "statusCode": 429,
  "retryAfter": 0,
  "error": "Too many requests",
  "message": "TOO_MANY_OTP_EMAILS"
}
{
  "statusCode": 500,
  "error": "Internal server error",
  "message": "UNABLE_TO_FIND_MAIL_TEMPLATE"
}

Set or reset email OTP POST

Providing a sudo token or an access token (if 2FA is disabled), configure a mail address for email OTP

Initiate an email address transfer POST

Providing a sudo token or an access token (if 2FA is disabled), send an email address verification code to a new email address to initiate an account email transfer. Wait at least 60 seconds between successive calls