---
title: "Update Password Policy"
method: PUT
path: "/passwordpolicies/{objectId}"
tags: ["Password Policy"]
---

# Update Password Policy

`PUT /passwordpolicies/{objectId}`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/passwordpolicies/{objectId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/passwordpolicies/:objectId/put.ts> (a function with typed inputs; its response is checked against the schema)

Update a password policy for an organization.

## Path parameters

- `objectId` string, byte, required

## Request body

- object
  - `groupIds` string[]
  - `organizationObjectId` string, byte
  - `policy` JumpcloudPasswordPasswordPolicy
    - `allowUnenrolledMFAPasswordReset` boolean
    - `allowUsernameSubstring` boolean
    - `daysAfterExpirationToSelfRecover` integer
    - `daysBeforeExpirationToForceReset` integer
    - `default` boolean
    - `description` string
    - `disallowCommonlyUsedPasswords` boolean
    - `disallowCustomBannedPasswords` boolean
    - `disallowNameSubstring` boolean
    - `disallowSequentialOrRepetitiveChars` boolean
    - `displayComplexityOnResetScreen` boolean
    - `effectiveDate` string, date-time
    - `enableDaysAfterExpirationToSelfRecover` boolean
    - `enableDaysBeforeExpirationToForceReset` boolean
    - `enableLockoutTimeInSeconds` boolean
    - `enableMaxHistory` boolean
    - `enableMaxLoginAttempts` boolean
    - `enableMinChangePeriodInDays` boolean
    - `enableMinLength` boolean
    - `enableNameConsecutiveChars` boolean
    - `enablePasswordExpirationInDays` boolean
    - `enableRecoveryEmail` boolean
    - `enableResetLockoutCounter` boolean
    - `lockoutTimeInSeconds` integer
    - `maxHistory` integer
    - `maxLoginAttempts` integer
    - `minChangePeriodInDays` integer
    - `minLength` integer
    - `name` string
    - `nameConsecutiveChars` integer
    - `needsLowercase` boolean
    - `needsNumeric` boolean
    - `needsSymbolic` boolean
    - `needsUppercase` boolean
    - `passwordExpirationInDays` integer
    - `precedence` integer
    - `resetLockoutCounterMinutes` integer

## Response `200`

A successful response.

- JumpcloudPasswordResponse
  - `cached` boolean
  - `groups` JumpcloudPasswordGroupResponse[]
    - `groupId` string, byte
    - `name` string
  - `objectId` string, byte
  - `organizationObjectId` string, byte
  - `policy` JumpcloudPasswordPasswordPolicy
    - `allowUnenrolledMFAPasswordReset` boolean
    - `allowUsernameSubstring` boolean
    - `daysAfterExpirationToSelfRecover` integer
    - `daysBeforeExpirationToForceReset` integer
    - `default` boolean
    - `description` string
    - `disallowCommonlyUsedPasswords` boolean
    - `disallowCustomBannedPasswords` boolean
    - `disallowNameSubstring` boolean
    - `disallowSequentialOrRepetitiveChars` boolean
    - `displayComplexityOnResetScreen` boolean
    - `effectiveDate` string, date-time
    - `enableDaysAfterExpirationToSelfRecover` boolean
    - `enableDaysBeforeExpirationToForceReset` boolean
    - `enableLockoutTimeInSeconds` boolean
    - `enableMaxHistory` boolean
    - `enableMaxLoginAttempts` boolean
    - `enableMinChangePeriodInDays` boolean
    - `enableMinLength` boolean
    - `enableNameConsecutiveChars` boolean
    - `enablePasswordExpirationInDays` boolean
    - `enableRecoveryEmail` boolean
    - `enableResetLockoutCounter` boolean
    - `lockoutTimeInSeconds` integer
    - `maxHistory` integer
    - `maxLoginAttempts` integer
    - `minChangePeriodInDays` integer
    - `minLength` integer
    - `name` string
    - `nameConsecutiveChars` integer
    - `needsLowercase` boolean
    - `needsNumeric` boolean
    - `needsSymbolic` boolean
    - `needsUppercase` boolean
    - `passwordExpirationInDays` integer
    - `precedence` integer
    - `resetLockoutCounterMinutes` integer

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)