---
title: "Change password"
method: POST
path: "/auth/v1/mfa/password/change"
---

# Change password

`POST /auth/v1/mfa/password/change`

API to change the password.

## Request body

- object
  - `deviceId` string, required — Unique ID of the device used for password validation. It should be the same device used to generate the MFA token.
  - `password` string, required — Current password.
  - `newPassword` string, required — New password.
  - `confirmPassword` string, required — Re-enter the new password.
  - `brand` string, required — Name of the brand or organisation that needs verification.
  - `token` string, required — Token generated from `/mfa/password/validate` .
  - `identifierType` 'MOBILE' | 'EMAIL' | 'USERNAME' | 'EXTERNALID', required — The type of identifier to identify the customer.
  - `identifierValue` string, required — Value of the identifier.

## Response `200`

200

- object
  - `status` object
    - `success` boolean
    - `code` integer
    - `message` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/revisions/de241f2ed9b3/schema)
