Skip to main content

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.

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

FieldValue
MethodPUT
Path/users/me/username
Auth requiredYes — Bearer token
Rate limit1 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

StatusMeaning
400The username is too short, too long, or no data was provided.
409The 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.