---
title: "PATCH /guilds/{guild_id}/members/@me"
method: PATCH
path: "/guilds/{guild_id}/members/@me"
---

# PATCH /guilds/{guild_id}/members/@me

`PATCH /guilds/{guild_id}/members/@me`

## Request body

- object
  - `nick` string, nullable
  - `avatar` string, byte, nullable
  - `bio` string, nullable
  - `banner` string, byte, nullable

## Response `200`

200 response for update_my_guild_member

- PrivateGuildMemberResponse
  - `avatar` string, nullable, required — the member's guild avatar hash
  - `avatar_decoration_data` UserAvatarDecorationResponse
    - `asset` string, required — the avatar decoration hash
    - `sku_id` string, snowflake, required
  - `banner` string, nullable, required — the member's guild banner hash
  - `communication_disabled_until` string, 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
  - `flags` integer, required — guild member flags represented as a bit set, defaults to 0
  - `joined_at` string, date-time, required — when the user joined the guild
  - `nick` string, nullable, required — this user's guild nickname
  - `pending` boolean, required — whether the user has not yet passed the guild's Membership Screening requirements
  - `premium_since` string, date-time, nullable, required — when the user started boosting the guild
  - `roles` SnowflakeType[], required — array of role object ids
  - `collectibles` UserCollectiblesResponse
    - `nameplate` UserNameplateResponse, required
      - `sku_id` string, snowflake, required
      - `asset` string, required — Path to the nameplate asset
      - `label` string, required — The label of this nameplate. Currently unused
      - `palette` union, required
        - 'crimson' — Crimson color palette
        - 'berry' — Berry color palette
        - 'sky' — Sky color palette
        - 'teal' — Teal color palette
        - 'forest' — Forest color palette
        - 'bubble_gum' — Bubble gum color palette
        - 'violet' — Violet color palette
        - 'cobalt' — Cobalt color palette
        - 'clover' — Clover color palette
        - 'lemon' — Lemon color palette
        - 'white' — White color palette
        - 'black' — Black color palette
  - `user` UserResponse, required
    - `id` string, snowflake, required
    - `username` string, required — the user's username, not unique across the platform
    - `avatar` string, nullable, required — the user's avatar hash
    - `discriminator` string, required — the user's Discord-tag
    - `public_flags` integer, required — the public flags on a user's account
    - `flags` integer, required
    - `bot` boolean — whether the user belongs to an OAuth2 application
    - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
    - `banner` string, nullable — the user's banner hash
    - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
    - `global_name` string, nullable, required — the user's display name, if it is set
    - `avatar_decoration_data` UserAvatarDecorationResponse
      - `asset` string, required — the avatar decoration hash
      - `sku_id` string, snowflake, required
    - `collectibles` UserCollectiblesResponse
      - `nameplate` UserNameplateResponse, required
        - `sku_id` string, snowflake, required
        - `asset` string, required — Path to the nameplate asset
        - `label` string, required — The label of this nameplate. Currently unused
        - `palette` union, required
          - 'crimson' — Crimson color palette
          - 'berry' — Berry color palette
          - 'sky' — Sky color palette
          - 'teal' — Teal color palette
          - 'forest' — Forest color palette
          - 'bubble_gum' — Bubble gum color palette
          - 'violet' — Violet color palette
          - 'cobalt' — Cobalt color palette
          - 'clover' — Clover color palette
          - 'lemon' — Lemon color palette
          - 'white' — White color palette
          - 'black' — Black color palette
    - `primary_guild` UserPrimaryGuildResponse, required
      - `identity_guild_id` string, snowflake, required
      - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
      - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
      - `badge` string, nullable, required — the server tag badge hash
  - `mute` boolean, required — whether the user is muted in voice channels
  - `deaf` boolean, required — whether the user is deafened in voice channels
  - `permissions` string

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

> 58 revisions in range; 4 could not be searched.

- **2026-06-05** `693bf1f99bba` — 2 breaking
  - 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[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
  - 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[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/guilds/:guild_id/members/@me/patch.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)
