---
title: "Get current user settings"
method: GET
path: "/users/@me/settings"
tags: ["Users"]
---

# Get current user settings

`GET /users/@me/settings`

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

## Response `200`

Success

- UserSettingsResponse
  - `status` string, required — The current online status of the user
  - `status_resets_at` string, date-time, nullable — ISO8601 timestamp of when the status will reset
  - `status_resets_to` string, nullable — The status to reset to after the scheduled reset
  - `theme` string, 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_guilds` SnowflakeStringType[], required — Guild IDs where direct messages are restricted
  - `bot_restricted_guilds` SnowflakeStringType[], required — Guild IDs where bot direct messages are restricted
  - `default_guilds_restricted` boolean, required — Whether new guilds have DM restrictions by default
  - `bot_default_guilds_restricted` boolean, required — Whether new guilds have bot DM restrictions by default
  - `inline_attachment_media` boolean, required — Whether to display attachments inline in chat
  - `inline_embed_media` boolean, required — Whether to display embed media inline in chat
  - `gif_auto_play` boolean, required — Whether GIFs auto-play in chat
  - `render_embeds` boolean, required — Whether to render message embeds
  - `render_reactions` boolean, required — Whether to display reactions on messages
  - `animate_emoji` boolean, required — Whether to animate custom emoji
  - `animate_stickers` 0 | 1 | 2, required — Sticker animation preference
  - `render_spoilers` 0 | 1 | 2, required — Spoiler rendering preference
  - `message_display_compact` boolean, required — Whether to use compact message display mode
  - `friend_source_flags` integer, required — Bitfield for friend request source permissions
  - `incoming_call_flags` integer, required — Bitfield for incoming call notification settings
  - `group_dm_add_permission_flags` integer, required — Bitfield for group DM add permissions
  - `guild_folders` object[], required — The folder structure for organizing guilds in the sidebar
    - `id` integer
    - `name` string, nullable — The display name of the folder
    - `color` integer
    - `flags` integer, required — Bitfield for guild folder display behaviour
    - `icon` 'folder' | 'star' | 'heart' | 'bookmark' | 'game_controller' | 'shield' | 'music_note', required — Guild folder icon
    - `guild_ids` SnowflakeStringType[], required — The IDs of guilds contained in this folder
  - `custom_status` CustomStatusResponse, required
    - `text` string, nullable — The custom status message text
    - `expires_at` string, date-time, nullable — ISO8601 timestamp of when the custom status expires
    - `emoji_id` string, snowflake
    - `emoji_name` string, nullable — The name of the emoji used in the status
    - `emoji_animated` boolean, required — Whether the status emoji is animated
  - `afk_timeout` integer, required
  - `time_format` 0 | 1 | 2, required — Time format preference
  - `developer_mode` boolean, required — Whether developer mode is enabled
  - `trusted_domains` string[], required — List of trusted external link domains
  - `default_hide_muted_channels` boolean, required — Whether muted channels are hidden by default in new guilds
  - `sensitive_content_friend_dm_filter` 0 | 1 | 2, required — Sensitive media filter level
  - `sensitive_content_non_friend_dm_filter` 0 | 1 | 2, required — Sensitive media filter level
  - `sensitive_content_guild_filter` 0 | 1, required — Sensitive media filter level for community channels
  - `suppress_unprivileged_self_mentions` boolean, required — Whether direct mentions and reply mentions from unprivileged users are suppressed
  - `suppress_unprivileged_self_mentions_bypass_user_ids` SnowflakeStringType[], required — User IDs that bypass self-mention suppression
  - `staff_dm_access_user_ids` SnowflakeStringType[], required — User IDs with Staff DM Access enabled
  - `synced_preferences` string, required — Account-wide client preferences as a base64-encoded protobuf snapshot. Empty string when nothing has been synced yet.
  - `profile_privacy` 0 | 1 | 2, required — Profile privacy visibility level
  - `default_share_voice_activity` boolean, 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.

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `401` — Unauthorized - Authentication is required or the token is invalid
- `403` — Forbidden - You do not have permission to perform this action
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

## Changes

> 20 revisions in range; 2 not diffed.

- **2026-09-18** `dd0ad4ea1c88` — 4 breaking, 6 info
  - the response property `custom_status/anyOf[#/components/schemas/CustomStatusResponse]/emoji_name` became nullable for the status `200`
  - the response property `custom_status/anyOf[#/components/schemas/CustomStatusResponse]/text` became nullable for the status `200`
  - the response property `guild_folders/items/name` became nullable for the status `200`
  - the response property `status_resets_to` became nullable for the status `200`
  - …6 more
- **2026-09-06** `a52a2cf49d9b` — 32 warning
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `400`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `401`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `403`
  - added the new `IP_BAN_DECLINED` enum value to the `code` response property for the response status `500`
  - …28 more
  - …this revision’s changelog is incomplete
- …earlier changes not shown

[Full history](https://skmtc.dev/fluxer/apis/fluxer-api/changes/users/@me/settings/get.md)

---

[API](https://skmtc.dev/fluxer/apis/fluxer-api.md) · [All operations](https://skmtc.dev/fluxer/apis/fluxer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fluxer/apis/fluxer-api/revisions/55834b33d5d5?raw)