v54

latestSwagger 2.0AGPL-3.0raw.githubusercontent.com2026-08-03397565628.8 KB

Users

Update user profile

put/api/v2/users/{user}/profile

Path parameters

userstring required

User ID, name, or me

Request body

avatar_urlstring uri

AvatarURL is only applied for users whose login type is password or none. For other login types the avatar is synced from the identity provider on login, so a submitted value is ignored.

namestring

usernamestring required

Response

avatar_urlstring uri

created_atstring date-time required

emailstring email required

has_ai_seatboolean

HasAISeat intentionally omits omitempty so the API always includes the field, even when false.

idstring uuid required

is_service_accountboolean

last_seen_atstring date-time

namestring

organization_idsstring[]

status'active' | 'dormant' | 'suspended'

theme_preferencestring

Deprecated: this value should be retrieved from codersdk.UserPreferenceSettings instead.

updated_atstring date-time

usernamestring required