---
title: "Update lockout policy"
method: PATCH
path: "/resources/configurations/v1/lockout-policy"
tags: ["Lockout policy"]
---

# Update lockout policy

`PATCH /resources/configurations/v1/lockout-policy`

## Request

- Base URL: `http://localhost:8181`
- URL: `http://localhost:8181/resources/configurations/v1/lockout-policy`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/docs/resources/configurations/v1/lockout-policy/patch.ts> (a function with typed inputs; its response is checked against the schema)

This route updates a lockout policy for all tenants. To update a lockout policy for a specific tenant, send the tenant’s ID in the **`frontegg-tenant-id`** header. To disable the lockout policy, make sure to set the enabled variable to false. The maximum attempts variable can also be changed to a number of your preference

## Headers

- `frontegg-tenant-id` string

## Request body

- LockoutPolicyRequest
  - `enabled` boolean, required: Determine whether the Lockout Policy is enabled
  - `maxAttempts` number, required: The number of the maximum login attempts user can do

## Response `200`

- LockoutPolicyResponse
  - `id` string, required
  - `enabled` boolean, required
  - `maxAttempts` number, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `404`: Lockout Policy not found. Try to use the Create Lockout Policy API

---

[API](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp.md) - [All operations](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/llms.txt) - [OpenAPI document](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/revisions/c496ae9e1c3e?raw)