Update User Settings

Updates the current user settings of the platform.

HTTP Request

PATCH/api/settings/users

Authorization

Authorization

• Required: Yes
• Permission: Staff or Admin
• Authentication: Token authentication

Request Body

Field	Type	Required	Description
users_default_user_status	Boolean	No	Default status for new users (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}'

Status Codes

Code	Description
200	Request logs retrieved successfully
400	Bad request — invalid query parameters
401	Unauthorized — authentication required
403	Forbidden — insufficient permissions
500	Internal server error

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)