# POST /admin/users/{username}/password

> Change the DS Server admin password: post a JSON object with newPassword, at least 8 characters, with Basic authorization; other user names return 404.

- **Product:** DS Server
- **Section:** Documentation
- **Kind:** Endpoint
- **Path:** DS Server > API Reference > Web API > Administration > /users/{username}/password > POST /admin/users/{username}/password
- **573 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/reference/web-api/administration/users-username-password/post/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/reference/web-api/administration/users-username-password/post/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/reference/web-api/administration/users-username-password/post/llms-full.txt

---

`POST` `https://example.com/admin/users/{username}/password`

### Description

Updates the password of the given username with a new password.

### Examples

This sample changes the admin password to a new given password.

```bash
# Request:
curl --location --request POST 'https://trial.dsserver.io/admin/users/admin/password' \
    --header 'Authorization: Basic YWRtaW46YWRtaW4=' \
    --header 'Content-Type: application/json' \
    --data-raw '{
            "newPassword": "newpassword"
        }'

# Response:
HTTP/1.1 200 OK
```

### Authorization

This endpoint supports the Basic authorization method:

#### Basic

| Header field | Description |
|---|---|
| Authorization | The username "admin" and your admin password are combined into a string separated by a colon, e.g.: admin:password. The resulting string is encoded using the RFC2045-MIME variant of Base64, except not limited to 76 char/line. The authorization method and a space i.e. "Basic " is then put before the encoded string. For example: `Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l` |

### Request Payload

| Type | Value |
|---|---|
| AdminPasswordUpdate | The AdminPasswordUpdate object contains the new password. |

#### AdminPasswordUpdate

| Name | Type | Value | Optional |
|---|---|---|---|
| newPassword | String | The new password. Minimum character length is 8. | no |

### Success Response

| Status | Description |
|---|---|
| 200 | On success, the HTTP status code in the response header is 200 (OK). |

### Error Response

| Status | Description |
|---|---|
| 401 | A 401 (Unauthorized) is returned, if the user is not authorized. |
| 400 | A 400 (Bad Request) is returned, if the password could not be updated or the password doesn't fulfill the minimum requirements. A password shorter than 8 characters returns the plain text "New password must be at least 8 characters long." |
| 404 | A 404 (Not Found) is returned, if the given username doesn't exist. The only user is "admin". |

---

## Nearby

- **Previous:** [/admin/users/{username}/password](https://docs.textcontrol.com/ds-server/reference/web-api/administration/users-username-password/llms-full.txt)
- **Next:** [/admin/securityprofiles](https://docs.textcontrol.com/ds-server/reference/web-api/administration/securityprofiles/llms-full.txt)