# Request password change

Step 1 of authenticated password change: validates the current password and stores the new password temporarily. Sends a confirmation code to the account email. Requires authentication and a valid current password.

Endpoint: POST /api/v1/accounts/password/change/request
Version: 1.0
Security: header

## Request fields (application/json):

  - `currentPassword` (string, required)
    Current account password
    Example: "PassW0rd!"

  - `newPassword` (string, required)
    New password, enforced by password policy
    Example: "PassW0rd!"

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation