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

Friend source flags

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

User online status

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

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

restricted_guildsSnowflakeType[]

Guilds with DM restrictions

bot_restricted_guildsSnowflakeType[]

Guilds with bot DM restrictions

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

Friend source flags

incoming_call_flagsinteger

Incoming call settings

group_dm_add_permission_flagsinteger

Group DM add permissions

afk_timeoutinteger

AFK timeout in seconds

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

suppress_unprivileged_self_mentions_bypass_user_idsSnowflakeType[] nullable

User IDs that bypass self-mention suppression

staff_dm_access_user_idsSnowflakeType[] nullable

User IDs with Staff DM Access enabled

profile_privacy0 | 1 | 2

Profile privacy visibility level

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_guildsSnowflakeType[] required

Guild IDs where direct messages are restricted

bot_restricted_guildsSnowflakeType[] 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

Friend source flags

incoming_call_flagsinteger required

Incoming call settings

group_dm_add_permission_flagsinteger required

Group DM add permissions

afk_timeoutinteger required

The idle timeout in seconds before going AFK

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_idsSnowflakeType[] required

User IDs that bypass self-mention suppression

staff_dm_access_user_idsSnowflakeType[] 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

No recorded changes to this endpoint across all 1 revision of this API.