PUT /users/me/username — Change your username

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

username

string

required

The new username to set for your account.

Response

Status: 200 OK

message

string

required

Confirmation message. Value is "Username updated successfully.".

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

cURL

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

Response

{
  "message": "Username updated successfully."
}

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

GET /users/me/outfits/sync — Incremental outfit sync

Auth

Wardrobe

Outfits

Images

Sync

Account

PUT /users/me/username — Change your username

Endpoint

Request body

Response

Error codes

Example

​Endpoint

​Request body

​Response

​Error codes

​Example

Endpoint

Request body

Response

Error codes

Example