auth.v1.ProfileService

UpdateProfile

Update the caller's mutable profile fields. Omitted fields are unchanged; present empty strings clear optional text fields.

Method

POST

Path

auth.v1.ProfileService/UpdateProfile

Service

auth.v1.ProfileService

Visibility

Authentication required

Authentication

Session token

MFA Requirement

Not required

POST

auth.v1.ProfileService/UpdateProfile

Request

Testnet

curl --request POST \ \
  --url 'https://api.testnet.polyester.com/auth.v1.ProfileService/UpdateProfile' \
  --header 'Content-Type: application/json' \
  --header 'Connect-Protocol-Version: 1' \
  --data '{
  "avatarUrl": "https://placehold.co/128x128.png",
  "bio": "Professional crypto trader and liquidity provider.",
  "twitter": "@polyester_exchange",
  "username": "trader_alpha",
  "website": "https://example.com"
}'

Responses

{
  "avatarUrl": "https://placehold.co/128x128.png",
  "bio": "Professional crypto trader and liquidity provider.",
  "createdAt": "2025-01-01T00:00:00Z",
  "currentTermsAccepted": false,
  "discord": "polyester_trader",
  "discordVerified": false,
  "nextUsernameChangeAt": "2025-01-01T00:00:00Z",
  "twitter": "@polyester_exchange",
  "twitterVerified": false,
  "username": "trader_alpha",
  "usernameUnlocked": false,
  "vipTier": 1,
  "website": "https://example.com"
}

Request

auth.v1.UserProfilePatch

Response

auth.v1.UserProfile

username string username must be empty or 3-32 chars of letters, digits, underscore, dot, hyphen

Public username for the root account. Use an empty string to clear it. Non-empty values must be 3 to 32 letters, digits, underscores, dots, or hyphens.

bio string bio must be empty or <= 256 characters and must not contain '<' or '>'

Short public bio. Use an empty string to clear it. Non-empty values must be at most 256 characters and cannot contain "<" or ">".

website string website must be empty or a valid http(s) URL

Public website URL. Use an empty string to clear it. Non-empty values must be valid http(s) URLs up to 256 characters.

twitter string twitter must be empty or a valid handle (letters, digits, underscore; without '@')

X/Twitter handle without "@". Use an empty string to clear it. Non-empty values must be 1 to 15 letters, digits, or underscores.

avatarUrl string avatar_url must be empty or a valid http(s) URL

Avatar URL. Use an empty string to clear it. Non-empty values must be valid http(s) URLs up to 256 characters.

username string max 32 chars /^[a-zA…3,32}$/

Public username for the root account. Usernames are unique case-insensitively and use 3 to 32 letters, digits, underscores, dots, or hyphens. Empty means no username is set.

bio string max 256 chars

Short public bio. Maximum length is 256 characters.

website string max 256 chars

Public website URL, if set. Maximum length is 256 characters.

twitter string max 15 chars /^[A-Za…1,15}$/

X/Twitter handle without "@". Maximum length is 15 characters.

twitterVerified boolean

Whether the X/Twitter handle for this account has been verified.

discord string max 64 chars

Discord handle or username without "@". Maximum length is 64 characters.

discordVerified boolean

Whether the Discord handle for this account has been verified.

avatarUrl string max 256 chars

Avatar URL, if set. Maximum length is 256 characters.

createdAt string (date-time)

Account creation time in UTC. This is the canonical "member since" timestamp.

nextUsernameChangeAt string (date-time)

Next time in UTC when the username can be changed again. Omitted when no cooldown applies.

vipTier integer (int32)

Current VIP tier for this root account. A value of 0 is the base tier. Read-only.

usernameUnlocked boolean

Whether this account is currently allowed to claim/change a username.

currentTermsAccepted boolean

Whether the caller's root account accepted the terms required for restricted actions. False when the required terms have not been accepted.

Possible errors: 5

Key	HTTP status	Connect code	Error	When
unauthenticated	401	unauthenticated	Unauthenticated	Authentication required.
permission-denied	403	permission_denied	Permission Denied	Permission denied.
invalid-argument	400	invalid_argument	Invalid Argument	Invalid argument.
not-found	404	not_found	Not Found	Not found.
unavailable	503	unavailable	Unavailable	Service unavailable.

POST

auth.v1.ProfileService/UpdateProfile

Request

Testnet

curl --request POST \ \
  --url 'https://api.testnet.polyester.com/auth.v1.ProfileService/UpdateProfile' \
  --header 'Content-Type: application/json' \
  --header 'Connect-Protocol-Version: 1' \
  --data '{
  "avatarUrl": "https://placehold.co/128x128.png",
  "bio": "Professional crypto trader and liquidity provider.",
  "twitter": "@polyester_exchange",
  "username": "trader_alpha",
  "website": "https://example.com"
}'

Responses

{
  "avatarUrl": "https://placehold.co/128x128.png",
  "bio": "Professional crypto trader and liquidity provider.",
  "createdAt": "2025-01-01T00:00:00Z",
  "currentTermsAccepted": false,
  "discord": "polyester_trader",
  "discordVerified": false,
  "nextUsernameChangeAt": "2025-01-01T00:00:00Z",
  "twitter": "@polyester_exchange",
  "twitterVerified": false,
  "username": "trader_alpha",
  "usernameUnlocked": false,
  "vipTier": 1,
  "website": "https://example.com"
}