Update User Settings

Updates the current user settings of the project

HTTP Request

PATCH/api/settings/users

Authorization

Authorization

• Required: Yes
• Permission: Staff with UsersSettingsPermission or Admin
• Permission Code: 1012
• Authentication: Token authentication

Request Body

Field	Type	Required	Description
users_default_user_status	Boolean	No	Default status for new users (active or not, default: false)
users_allow_multiple_sessions	Boolean	No	Allow users to have multiple active sessions (default: false)
users_otp_code_len	Integer	No	Length of OTP codes (default: 5)
users_otp_code_ttl	Integer	No	OTP code time-to-live in seconds (default: 120)

Example Requests

🐍 Python

1# Update user settings
2response = requests.patch('http://www.example.com/api/settings/users', 
3  json={
4      'users_default_user_status': True,
5      'users_allow_multiple_sessions': True,
6      'users_otp_code_len': 6,
7      'users_otp_code_ttl': 300
8  },
9  headers={'Authorization': 'Token <your_api_key>'}
10)
11print(response.json())

🌐 Curl

1# Update user settings
2curl -X PATCH "http://www.example.com/api/settings/users" -H "Authorization: Token <your_api_key>" -H "Content-Type: application/json" -d '{
3  "users_default_user_status": true,
4  "users_allow_multiple_sessions": true,
5  "users_otp_code_len": 6,
6  "users_otp_code_ttl": 300
7}'

Response Fields

Field	Type	Description
users_default_user_status	Boolean	Default status for new users (default: false)
users_allow_multiple_sessions	Boolean	Allow users to have multiple active sessions (default: false)
users_otp_code_len	Integer	Length of OTP codes (default: 5)
users_otp_code_ttl	Integer	OTP code time-to-live in seconds (default: 120)

Example Response

{
    "users_default_user_status": true,
    "users_allow_multiple_sessions": false,
    "users_otp_code_len": 6,
    "users_otp_code_ttl": 60
}