---
title: "Update a User Password"
method: PATCH
path: "/v1/users/{id}/update-password"
tags: ["Users API"]
---

# Update a User Password

`PATCH /v1/users/{id}/update-password`

Use this endpoint to change a user's password by providing the current (old) password along with the new one. Ideal for self-service password updates.

## Path parameters

- `id` string, required

## Request body

- UserPasswordInput — Information used to update a user's password.
  - `newPassword` string, required — New user password.
  - `oldPassword` string — Current user password.

## Response `204`

If the request is successful, you will receive an empty response.

## Other responses

- `400`
- `401`
- `404`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)