Users

Get current user settings

Retrieves the current user's settings and preferences, including notification settings, privacy options, and display preferences. Only accessible to the authenticated user.

get/users/@me/settings

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

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' required

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.