> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drssed.app/llms.txt
> Use this file to discover all available pages before exploring further.

# PUT /users/me/username — Change your username

> Update the username for your account. Must be unique across all users. Rate limited to 1 request per hour. Returns a success message on update.

Call `PUT /users/me/username` to change your account username. The new username must be unique — if it is already taken, the API returns a `409 Conflict` response. This endpoint is strictly rate limited to one request per hour.

## Endpoint

| Field         | Value                |
| ------------- | -------------------- |
| Method        | `PUT`                |
| Path          | `/users/me/username` |
| Auth required | Yes — Bearer token   |
| Rate limit    | 1 per hour           |

## Request body

<ParamField body="username" type="string" required>
  The new username to set for your account.
</ParamField>

## Response

**Status: 200 OK**

<ResponseField name="message" type="string" required>
  Confirmation message. Value is `"Username updated successfully."`.
</ResponseField>

## Error codes

| Status | Meaning                                                                                            |
| ------ | -------------------------------------------------------------------------------------------------- |
| `400`  | The username is too short, too long, or no data was provided.                                      |
| `409`  | The username is already in use by another account. The response body includes `"key": "username"`. |

## Example

```bash cURL theme={null}
curl --request PUT \
  --url https://api.drssed.com/users/me/username \
  --header "Authorization: Bearer <token>" \
  --header "Content-Type: application/json" \
  --data '{
    "username": "newhandle"
  }'
```

```json Response theme={null}
{
  "message": "Username updated successfully."
}
```

<Note>
  This endpoint is rate limited to **1 request per hour**. Plan username changes accordingly — users cannot change their username again until the window resets.
</Note>