Skip to navigation

AccountPasswordRules Resource

View as Markdown

The AccountPasswordRules resource provides methods that allow you to obtain and update account password rules, as well as membership and account rules.

Methods supported

MethodDescription
getGET /restapi/v2.1/accounts/{accountId}/settings/password_rules
Gets the password rules for an account.
getForUserGET /restapi/v2.1/current_user/password_rules
Gets membership account password rules.
updatePUT /restapi/v2.1/accounts/{accountId}/settings/password_rules
Updates the password rules for an account.

AccountPasswordRules properties

PropertyTypeDescription
expirePasswordstringWhen true, passwords expire. The default value is false.
expirePasswordDaysstringThe number of days before passwords expire. To use this property, the expirePassword property must be set to true.
expirePasswordDaysMetadataaccountPasswordExpirePasswordDaysMetadata that indicates whether the expirePasswordDays property is editable.
lockoutDurationMinutesstringThe number of minutes a user is locked out of the system after three failed login attempts. The default value is 2.
lockoutDurationMinutesMetadataaccountPasswordLockoutDurationMinutesMetadata that indicates whether the lockoutDurationMinutes property is editable.
lockoutDurationTypestringThe interval associated with the user lockout after a failed login attempt.

Possible values are:
  • minutes (default)
  • hours
  • days
lockoutDurationTypeMetadataaccountPasswordLockoutDurationTypeMetadata that indicates whether the lockoutDurationType property is editable.
minimumPasswordAgeDaysstringThe minimum number of days after a password is set before it can be changed. This value can be 0 or more days. The default value is 0.
minimumPasswordAgeDaysMetadataaccountPasswordMinimumPasswordAgeDaysMetadata that indicates whether the minimumPasswordAgeDays property is editable.
minimumPasswordLengthstringThe minimum number of characters in the password. This value must be a number between 6 and 15. The default value is 6.
minimumPasswordLengthMetadataaccountMinimumPasswordLengthMetadata that indicates whether the minimumPasswordLength property is editable.
passwordIncludeDigitstringWhen true, passwords must include a digit. The default value is false.
passwordIncludeDigitOrSpecialCharacterstringWhen true, passwords must include either a digit or a special character. The default value is false.

Note: Passwords cannot include angle brackets (< >) or spaces.
passwordIncludeLowerCasestringWhen true, passwords must include a lowercase letter. The default value is false.
passwordIncludeSpecialCharacterstringWhen true, passwords must include a special character. The default value is false.

Note: Passwords cannot include angle brackets (< >) or spaces.
passwordIncludeUpperCasestringWhen true, passwords must include an uppercase letter. The default value is false.
passwordStrengthTypestringThe type of password strength. Possible values are:
  • basic: The minimum password length is 6 characters with no other password requirements.
  • medium: The minimum password length is 7 characters. Passwords must also have one uppercase letter, one lowercase letter, and one number or special character.
  • strong: The minimum password length is 9 characters. Passwords must also have one uppercase letter, one lowercase letter, one number, and one special character.
  • custom: This option enables you to customize password requirements, including the following properties:
  • minimumPasswordLength
  • minimumPasswordAgeDays
  • passwordIncludeDigit
  • passwordIncludeDigitOrSpecialCharacter
  • passwordIncludeLowerCase
  • passwordIncludeSpecialCharacter
  • passwordIncludeUpperCase
  • questionsRequired
passwordStrengthTypeMetadataaccountPasswordStrengthTypeMetadata that indicates whether the passwordStrengthType property is editable.
questionsRequiredstringThe number of security questions required to confirm the user’s identity before the user can reset their password. The default value is 0.
questionsRequiredMetadataaccountPasswordQuestionsRequiredMetadata that indicates whether the questionsRequired property is editable.