> **Source:** https://knowledge.leegality.com/sign-station/api/change-password
> **Site:** Leegality Knowledge Base — https://knowledge.leegality.com
> **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration.
> **Navigation:** Every article on this site has a plain-text version at `<article-url>.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt
> **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt

---
# PUT /api/v1/users/change-password — Change user password

Changes the password for the currently authenticated user. The new password must comply with the organization's password policy.

**Authentication:** `X-Auth-Token` header required on every request.

## Request URL

```
PUT https://app1.leegality.com/api/api/v1/users/change-password
```

**Environments:**
- Production: `https://app1.leegality.com/api/api/v1/users/change-password`
- Sandbox: `https://sandbox.leegality.com/api/api/v1/users/change-password`

---

## Request Body

**Content-Type:** `application/json`

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `currentPassword` | string | Yes | The current password of the user | `TestPassword@123` |
| `newPassword` | string | Yes | The new password to set for the user | `NewPassword@123` |
| `confirmPassword` | string | Yes | Confirmation of the new password | `NewPassword@123` |

### Sample Request

```json
{
  "currentPassword": "TestPassword@123",
  "newPassword": "NewPassword@123",
  "confirmPassword": "NewPassword@123"
}
```

---

## Responses

### 200 — Password changed successfully

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Response code indicating success or failure | `LE_SS_002` |
| `message` | string | No | Response message providing additional information | `Requested record has been deleted.` |
| `data` | object | No | Additional data related to the response, if any. | — |

### 400 — Invalid request data or passwords don't match

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_400` |
| `errors` | array\<ErrorDetailChangePassword400VO\> | No | List of error details See **ErrorDetailChangePassword400VO** below. | — |

#### ErrorDetailChangePassword400VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `New password and confirm password do not match` |
| `path` | string | No | API path that generated the error | `/api/v1/users/change-password` |

### 401 — Current password is incorrect

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_401` |
| `errors` | array\<ErrorDetailChangePassword401VO\> | No | List of error details See **ErrorDetailChangePassword401VO** below. | — |

#### ErrorDetailChangePassword401VO

Password change request

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Authentication failed. Invalid username or password.` |
| `path` | string | No | API path that generated the error | `/api/v1/users/change-password` |
| `code` | string | No | Specific error code | `LE_ERR_SS_301` |

### 500 — Internal server error

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_500` |
| `errors` | array\<ErrorDetailToken500VO\> | No | List of error details See **ErrorDetailToken500VO** below. | — |

#### ErrorDetailToken500VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Internal Server Error` |
| `path` | string | No | API path that generated the error | `null` |
| `code` | string | No | Specific error code | `null` |

### Sample Response (200)

```json
{
  "code": "LE_SS_002",
  "message": "Requested record has been deleted.",
  "data": {}
}
```