Users

Update current user settings

Updates the current user's settings and preferences. Allows modification of notification settings, privacy options, display preferences, and other user-configurable options. Returns updated settings.

patch/users/@me/settings

Request body

flagsinteger

Bitfield of user settings flags

status'online' | 'dnd' | 'idle' | 'invisible'

User online status

status_resets_to'online' | 'dnd' | 'idle' | 'invisible'

User online status

theme'dark' | 'dark_legacy' | 'coal' | 'light' | 'system'

UI theme preference

locale'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en-GB' | 'en-US' | 'es-ES' | 'es-419' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'nl' | 'no' | 'pl' | 'pt-BR' | 'ro' | 'ru' | 'sv-SE' | 'th' | 'tr' | 'uk' | 'vi' | 'zh-CN' | 'zh-TW'

The locale code for the user interface language

default_guilds_restrictedboolean

Default DM restriction for new guilds

bot_default_guilds_restrictedboolean

Default bot DM restriction for new guilds

inline_attachment_mediaboolean

Display attachments inline

inline_embed_mediaboolean

Display embed media inline

gif_auto_playboolean

Auto-play GIFs

render_embedsboolean

Render message embeds

render_reactionsboolean

Display reactions

animate_emojiboolean

Animate custom emoji

animate_stickers0 | 1 | 2

Sticker animation preference

render_spoilers0 | 1 | 2

Spoiler rendering preference

message_display_compactboolean

Compact message display

friend_source_flagsinteger

Bitfield for friend request source permissions

incoming_call_flagsinteger

Bitfield for incoming call notification settings

group_dm_add_permission_flagsinteger

Bitfield for group DM add permissions

afk_timeoutinteger

AFK timeout in seconds (60-600)

time_format0 | 1 | 2

Time format preference

developer_modeboolean

Developer mode enabled

trusted_domainsstring[]

Trusted external link domains. Use "*" to trust all domains.

default_hide_muted_channelsboolean

Hide muted channels by default in new guilds

sensitive_content_friend_dm_filter0 | 1 | 2

Sensitive media filter level

sensitive_content_non_friend_dm_filter0 | 1 | 2

Sensitive media filter level

sensitive_content_guild_filter0 | 1

Sensitive media filter level for community channels

suppress_unprivileged_self_mentionsboolean

Suppress direct mentions and reply mentions from unprivileged users

profile_privacy0 | 1 | 2

Profile privacy visibility level

default_share_voice_activityboolean

Default share_voice_activity applied to new friend relationships

synced_preferencesstring nullable

Account-wide client preferences as a base64-encoded protobuf snapshot. Replaces the entire stored snapshot; pass null to clear it.

Response

Success

statusstring required

The current online status of the user

status_resets_atstring date-time nullable

ISO8601 timestamp of when the status will reset

status_resets_tostring nullable

The status to reset to after the scheduled reset

themestring required

The UI theme preference

The locale code for the user interface language

restricted_guildsSnowflakeStringType[] required

Guild IDs where direct messages are restricted

bot_restricted_guildsSnowflakeStringType[] required

Guild IDs where bot direct messages are restricted

default_guilds_restrictedboolean required

Whether new guilds have DM restrictions by default

bot_default_guilds_restrictedboolean required

Whether new guilds have bot DM restrictions by default

inline_attachment_mediaboolean required

Whether to display attachments inline in chat

inline_embed_mediaboolean required

Whether to display embed media inline in chat

gif_auto_playboolean required

Whether GIFs auto-play in chat

render_embedsboolean required

Whether to render message embeds

render_reactionsboolean required

Whether to display reactions on messages

animate_emojiboolean required

Whether to animate custom emoji

animate_stickers0 | 1 | 2 required

Sticker animation preference

render_spoilers0 | 1 | 2 required

Spoiler rendering preference

message_display_compactboolean required

Whether to use compact message display mode

friend_source_flagsinteger required

Bitfield for friend request source permissions

incoming_call_flagsinteger required

Bitfield for incoming call notification settings

group_dm_add_permission_flagsinteger required

Bitfield for group DM add permissions

afk_timeoutinteger required

time_format0 | 1 | 2 required

Time format preference

developer_modeboolean required

Whether developer mode is enabled

trusted_domainsstring[] required

List of trusted external link domains

default_hide_muted_channelsboolean required

Whether muted channels are hidden by default in new guilds

sensitive_content_friend_dm_filter0 | 1 | 2 required

Sensitive media filter level

sensitive_content_non_friend_dm_filter0 | 1 | 2 required

Sensitive media filter level

sensitive_content_guild_filter0 | 1 required

Sensitive media filter level for community channels

suppress_unprivileged_self_mentionsboolean required

Whether direct mentions and reply mentions from unprivileged users are suppressed

suppress_unprivileged_self_mentions_bypass_user_idsSnowflakeStringType[] required

User IDs that bypass self-mention suppression

staff_dm_access_user_idsSnowflakeStringType[] required

User IDs with Staff DM Access enabled

synced_preferencesstring required

Account-wide client preferences as a base64-encoded protobuf snapshot. Empty string when nothing has been synced yet.

profile_privacy0 | 1 | 2 required

Profile privacy visibility level

default_share_voice_activityboolean required

Default value of share_voice_activity applied to newly accepted friend relationships. Read-only here; mutated via PUT /users/@me/settings/voice-activity-sharing.

Changes

Changed in 5 of the 21 revisions of this API.73234

Sep 18, 2026dd0ad4ea1c8879See the full diff
- ▲
  request property ///// list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ▲
  request property ///// list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ▲
  request property // list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ▲
  the response property ///// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ///// became nullable for the status
  response-property-became-nullable
- ▲
  the response property // became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ○
  the request property ///// became nullable
  request-property-became-nullable
- ○
  the request property ///// became nullable
  request-property-became-nullable
- ○
  the request property // became nullable
  request-property-became-nullable
- ○
  response property custom_status/anyOf[CustomStatusResponse]/emoji_name list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property custom_status/anyOf[CustomStatusResponse]/text list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property guild_folders/items/name list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property status_resets_to list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  the ////// response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status
  response-property-pattern-changed
- ○
  the / response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status
  response-property-pattern-changed
Sep 11, 2026b7b12069ba8d1See the full diff
- ○
  the / request property's maxLength was increased from 349528 to 699052
  request-property-max-length-increased
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 6, 2026a52a2cf49d9b32See the full diff
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Sep 5, 20264dbb738a3e224See the full diff
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
Sep 3, 2026fa36b1b48ca520See the full diff
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 21 revisions, 2 have no diff computed.

Full history