Skip to main content
PUT
/
v1
/
user
/
username
Update Username
curl --request PUT \
  --url https://api.convallax.com/v1/user/username \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "trader_123"
}
'
{
  "success": true,
  "username": "trader_123"
}
Set or change the authenticated user’s display username. Must be 3-20 characters — letters, numbers, and underscores only. Usernames are unique across Convallax, so a taken name returns 409.

Authorizations

​
Authorization
string
header
required

Privy access token from the Convallax dashboard, sent as Authorization: Bearer <jwt>.

Body

application/json
​
username
string
required

3-20 chars: letters, numbers, underscores.

Required string length: 3 - 20
Pattern: ^[a-zA-Z0-9_]+$
Example:

"trader_123"

Response

Username updated

​
success
boolean
​
username
string
Example:

"trader_123"