Skip to main content
PATCH
/
settings
/
auth
Update auth settings
curl --request PATCH \
  --url https://api.wacht.dev/settings/auth \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": {
    "enabled": true,
    "required": true,
    "verify_signup": true,
    "otp_verification_allowed": true,
    "magic_link_verification_allowed": true
  },
  "phone": {
    "enabled": true,
    "required": true,
    "verify_signup": true,
    "sms_verification_allowed": true,
    "whatsapp_verification_allowed": true
  },
  "username": {
    "enabled": true,
    "required": true,
    "min_length": 128,
    "max_length": 128
  },
  "password": {
    "enabled": true,
    "min_length": 128,
    "require_lowercase": true,
    "require_uppercase": true,
    "require_number": true,
    "require_special": true
  },
  "name": {
    "first_name_enabled": true,
    "first_name_required": true,
    "last_name_enabled": true,
    "last_name_required": true
  },
  "authentication_factors": {
    "email_password_enabled": true,
    "username_password_enabled": true,
    "sso_enabled": true,
    "web3_wallet_enabled": true,
    "email_otp_enabled": true,
    "phone_otp_enabled": true,
    "magic_link": {
      "enabled": true,
      "require_same_device": true
    },
    "passkey": {
      "enabled": true,
      "prompt_registration_on_auth": true,
      "allow_autofill": true
    },
    "second_factor_authenticator_enabled": true,
    "second_factor_backup_code_enabled": true
  },
  "second_factor_policy": "optional",
  "first_factor": "email_password",
  "backup_code": {
    "enabled": true,
    "required": true
  },
  "web3_wallet": {
    "enabled": true,
    "required": true
  },
  "multi_session_support": "enabled",
  "session_token_lifetime": 123,
  "session_validity_period": 123,
  "session_inactive_timeout": 123
}
'

Authorizations

​
Authorization
string
header
required

API key authentication (format: Bearer {api_key})

Body

application/json
​
email
object
​
phone
object
​
username
object
​
password
object
​
name
object
​
authentication_factors
object
​
second_factor_policy
enum<string>
Available options:
optional,
required,
no_second_factor
​
first_factor
enum<string>
Available options:
email_password,
username_password,
sso,
web3_wallet,
email_otp,
phone_otp,
magic_link,
passkey
​
backup_code
object
​
web3_wallet
object
​
multi_session_support
enum<string>
Available options:
enabled,
disabled
​
session_token_lifetime
integer

Session token lifetime in seconds

​
session_validity_period
integer

Session validity period in seconds

​
session_inactive_timeout
integer

Session inactive timeout in seconds

Response

200

Auth settings updated successfully