PATCH /api/lunasa/user/config/password

Update user password related configuration.

User Privileges

Users with the following role privileges can perform this command:

admin

Parameters

history

Number of previous passwords remembered.

Use: Not Required

JSON Schema:

   Object
   type: integer
   format: uint32
   minimum: 1
   maximum: 10

expiryDays

Password expiration period in days.

Use: Not Required

JSON Schema:

   Object
   type: integer
   format: uint32
   minimum: 1
   maximum: 365

Note: Expiry days are calculated based on UTC time, regardless of the timezone configured on the appliance. For example, if the expiry is set to 2 days and the password was changed on Thu, Sep 16, 15:59:47 EDT 2025, it will expire at 23:59:59 UTC on Sep 18 (which corresponds to 19:59:59 EDT on Sep 18, 2025).

minimumLength

Minimum password length.

Use: Not Required

JSON Schema:

   Object
   type: integer
   format: uint32
   minimum: 8
   maximum: 30

The following table shows defined values for parameters.

Parameter	Range	Default Value
history	1 - 10	4
expiryDays	1 - 365	90
minimumLength	8 - 30	8

Responses

204

Success

400

FRAMEWORK_BAD_REQUEST

Returned when the input data does not conform to the required validation schema.

500

APPLIANCE_USER_FAILED_TO_UPDATE_PASSWORD_CONFIG

Failed to update the password configuration.

Example Request

   PATCH
   https://1.2.3.4:8443/api/lunasa/user/config/password
   {
      "expiryDays": 3,
      "history": 2
   }

Example Result

{
}