PATCH /guilds/:guild_id/members/@me — discord-http-api-preview

patch/guilds/{guild_id}/members/@me

Request body

nickstring nullable

avatarstring byte nullable

biostring nullable

bannerstring byte nullable

Response

200 response for update_my_guild_member

avatarstring nullable required

the member's guild avatar hash

bannerstring nullable required

the member's guild banner hash

communication_disabled_untilstring date-time nullable required

when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out

flagsinteger required

guild member flags represented as a bit set, defaults to 0

joined_atstring date-time required

when the user joined the guild

nickstring nullable required

this user's guild nickname

pendingboolean required

whether the user has not yet passed the guild's Membership Screening requirements

premium_sincestring date-time nullable required

when the user started boosting the guild

rolesSnowflakeType[] required

array of role object ids

muteboolean required

whether the user is muted in voice channels

deafboolean required

whether the user is deafened in voice channels

permissionsstring

Changes

Changed in 4 of the 58 revisions of this API.220

Aug 10, 202637e3f56d26681See the full diff
- ○
  the bio request property's maxLength was increased from 190 to 300
  request-property-max-length-increased
Jun 5, 2026693bf1f99bba2See the full diff
- ▲
  added subschema #1: CRIMSON subschema #2: BERRY subschema #3: SKY subschema #4: TEAL subschema #5: FOREST subschema #6: BUBBLE_GUM subschema #7: VIOLET subschema #8: COBALT subschema #9: CLOVER subschema #10: LEMON subschema #11: WHITE subschema #12: BLACK to the collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/palette response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added subschema #1: CRIMSON subschema #2: BERRY subschema #3: SKY subschema #4: TEAL subschema #5: FOREST subschema #6: BUBBLE_GUM subschema #7: VIOLET subschema #8: COBALT subschema #9: CLOVER subschema #10: LEMON subschema #11: WHITE subschema #12: BLACK to the user/collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/palette response property oneOf list for the response status 200
  response-property-one-of-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 4, 2026e200830e509a18See the full diff
- ○
  the response property avatar became required for the status 200
  response-property-became-required
- ○
  the response property avatar_decoration_data/oneOf[UserAvatarDecorationResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property banner became required for the status 200
  response-property-became-required
- ○
  the response property collectibles/oneOf[UserCollectiblesResponse]/nameplate became required for the status 200
  response-property-became-required
- ○
  the response property collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property communication_disabled_until became required for the status 200
  response-property-became-required
- ○
  the response property nick became required for the status 200
  response-property-became-required
- ○
  the response property premium_since became required for the status 200
  response-property-became-required
- ○
  the response property user/avatar became required for the status 200
  response-property-became-required
- ○
  the response property user/avatar_decoration_data/oneOf[UserAvatarDecorationResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property user/collectibles/oneOf[UserCollectiblesResponse]/nameplate became required for the status 200
  response-property-became-required
- ○
  the response property user/collectibles/oneOf[UserCollectiblesResponse]/nameplate/oneOf[UserNameplateResponse]/sku_id became required for the status 200
  response-property-became-required
- ○
  the response property user/global_name became required for the status 200
  response-property-became-required
- ○
  the response property user/primary_guild became required for the status 200
  response-property-became-required
- ○
  the response property user/primary_guild/oneOf[UserPrimaryGuildResponse]/badge became required for the status 200
  response-property-became-required
- ○
  the response property user/primary_guild/oneOf[UserPrimaryGuildResponse]/identity_enabled became required for the status 200
  response-property-became-required
- ○
  the response property user/primary_guild/oneOf[UserPrimaryGuildResponse]/identity_guild_id became required for the status 200
  response-property-became-required
- ○
  the response property user/primary_guild/oneOf[UserPrimaryGuildResponse]/tag became required for the status 200
  response-property-became-required
Jan 8, 2026805ec88c75e41See the full diff
- ○
  the request property bio became nullable
  request-property-became-nullable

Full history