Guilds

Update guild member

Update guild member. Requires manage_members permission. Can modify member nickname, voice state, and other member properties.

patch/guilds/{guild_id}/members/{user_id}

Path parameters

guild_idstring snowflake required

The ID of the guild

user_idstring snowflake required

The ID of the user

Request body

nickstring nullable

The nickname to set for the member (1-32 characters)

rolesSnowflakeType[]

Array of role IDs to assign to the member (max 100)

avatarstring byte

Base64-encoded image data

bannerstring byte

Base64-encoded image data

biostring nullable

The member guild profile bio (1-320 characters)

pronounsstring nullable

The member guild profile pronouns (1-40 characters)

accent_colorinteger nullable

The accent color for the member guild profile as an integer

profile_flagsinteger

Member profile flags

mention_flags0 | 1 | 2

Reply mention preference

muteboolean

Whether the member is muted in voice channels

deafboolean

Whether the member is deafened in voice channels

communication_disabled_untilstring date-time nullable

ISO8601 timestamp until which the member is timed out

timeout_reasonstring nullable

The reason for timing out the member (1-512 characters)

channel_idstring snowflake

connection_idstring nullable

The voice connection ID for the member

Response

Success

nickstring nullable

The nickname of the member in this guild

avatarstring nullable

The hash of the member guild-specific avatar

bannerstring nullable

The hash of the member guild-specific banner

accent_colorinteger

rolesstring[] required

Array of role IDs the member has

joined_atstring date-time required

ISO8601 timestamp of when the user joined the guild

muteboolean required