Skip to main content
PATCH
/
users
/
@me
/
settings
Update current user settings
curl --request PATCH \
  --url https://api.fluxer.app/v1/users/@me/settings \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "flags": 1073741823,
  "status": "online",
  "status_resets_at": "<string>",
  "status_resets_to": "online",
  "theme": "dark",
  "locale": "ar",
  "restricted_guilds": [
    "<string>"
  ],
  "bot_restricted_guilds": [
    "<string>"
  ],
  "default_guilds_restricted": true,
  "bot_default_guilds_restricted": true,
  "inline_attachment_media": true,
  "inline_embed_media": true,
  "gif_auto_play": true,
  "render_embeds": true,
  "render_reactions": true,
  "animate_emoji": true,
  "animate_stickers": 0,
  "render_spoilers": 0,
  "message_display_compact": true,
  "friend_source_flags": 1073741823,
  "incoming_call_flags": 1073741823,
  "group_dm_add_permission_flags": 1073741823,
  "guild_folders": [
    {
      "id": -1,
      "guild_ids": [
        "<string>"
      ],
      "name": "<string>",
      "color": 1073741823,
      "flags": 1073741823,
      "icon": "folder"
    }
  ],
  "custom_status": {
    "text": "<string>",
    "expires_at": "<string>",
    "emoji_id": "<string>",
    "emoji_name": "<string>"
  },
  "afk_timeout": 123,
  "time_format": 0,
  "developer_mode": true,
  "trusted_domains": [
    "<string>"
  ],
  "default_hide_muted_channels": true
}
'
{
  "status": "<string>",
  "theme": "<string>",
  "locale": "ar",
  "restricted_guilds": [
    "<string>"
  ],
  "bot_restricted_guilds": [
    "<string>"
  ],
  "default_guilds_restricted": true,
  "bot_default_guilds_restricted": true,
  "inline_attachment_media": true,
  "inline_embed_media": true,
  "gif_auto_play": true,
  "render_embeds": true,
  "render_reactions": true,
  "animate_emoji": true,
  "animate_stickers": 0,
  "render_spoilers": 0,
  "message_display_compact": true,
  "friend_source_flags": 1073741823,
  "incoming_call_flags": 1073741823,
  "group_dm_add_permission_flags": 1073741823,
  "guild_folders": [
    {
      "guild_ids": [
        "<string>"
      ],
      "id": -1,
      "name": "<string>",
      "color": 1073741823,
      "flags": 1073741823,
      "icon": "folder"
    }
  ],
  "custom_status": {
    "emoji_animated": true,
    "text": "<string>",
    "expires_at": "2023-11-07T05:31:56Z",
    "emoji_id": "<string>",
    "emoji_name": "<string>"
  },
  "afk_timeout": 1073741823,
  "time_format": 0,
  "developer_mode": true,
  "trusted_domains": [
    "<string>"
  ],
  "default_hide_muted_channels": true,
  "status_resets_at": "2023-11-07T05:31:56Z",
  "status_resets_to": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bot token: Authorization: Bot <token>. This is the primary authentication method for bot applications.

Body

application/json
​
flags
integer<int32>

Friend source flags

Required range: 0 <= x <= 2147483647
​
status
enum<string>

User online status

Available options:
online,
dnd,
idle,
invisible
​
status_resets_at

When status resets

​
status_resets_to
enum<string> | null

User online status

Available options:
online,
dnd,
idle,
invisible
​
theme
enum<string>

UI theme preference

Available options:
dark,
coal,
light,
system
​
locale
enum<string>

The locale code for the user interface language

Available options:
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
​
restricted_guilds
string<snowflake>[]

Guilds with DM restrictions

Maximum array length: 200
​
bot_restricted_guilds
string<snowflake>[]

Guilds with bot DM restrictions

Maximum array length: 200
​
default_guilds_restricted
boolean

Default DM restriction for new guilds

​
bot_default_guilds_restricted
boolean

Default bot DM restriction for new guilds

​
inline_attachment_media
boolean

Display attachments inline

​
inline_embed_media
boolean

Display embed media inline

​
gif_auto_play
boolean

Auto-play GIFs

​
render_embeds
boolean

Render message embeds

​
render_reactions
boolean

Display reactions

​
animate_emoji
boolean

Animate custom emoji

​
animate_stickers
enum<integer>

Sticker animation preference

Available options:
0,
1,
2
​
render_spoilers
enum<integer>

Spoiler rendering preference

Available options:
0,
1,
2
​
message_display_compact
boolean

Compact message display

​
friend_source_flags
integer<int32>

Friend source flags

Required range: 0 <= x <= 2147483647
​
incoming_call_flags
integer<int32>

Incoming call settings

Required range: 0 <= x <= 2147483647
​
group_dm_add_permission_flags
integer<int32>

Group DM add permissions

Required range: 0 <= x <= 2147483647
​
guild_folders
object[]

Guild folder organization

Maximum array length: 200
​
custom_status
object

Custom status

​
afk_timeout
integer<int53>

AFK timeout in seconds

​
time_format
enum<integer>

Time format preference

Available options:
0,
1,
2
​
developer_mode
boolean

Developer mode enabled

​
trusted_domains
string[]

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

Maximum array length: 1000
Required string length: 1 - 253
​
default_hide_muted_channels
boolean

Hide muted channels by default in new guilds

Response

Success

​
status
string
required

The current online status of the user

​
theme
string
required

The UI theme preference

​
locale
enum<string>
required

The locale code for the user interface language

Available options:
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
​
restricted_guilds
string<snowflake>[]
required

Guild IDs where direct messages are restricted

Maximum array length: 200
​
bot_restricted_guilds
string<snowflake>[]
required

Guild IDs where bot direct messages are restricted

Maximum array length: 200
​
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
enum<integer>
required

Sticker animation preference setting

Available options:
0,
1,
2
​
render_spoilers
enum<integer>
required

Spoiler rendering preference setting

Available options:
0,
1,
2
​
message_display_compact
boolean
required

Whether to use compact message display mode

​
friend_source_flags
integer<int32>
required

Friend source flags

Required range: 0 <= x <= 2147483647
​
incoming_call_flags
integer<int32>
required

Incoming call settings

Required range: 0 <= x <= 2147483647
​
group_dm_add_permission_flags
integer<int32>
required

Group DM add permissions

Required range: 0 <= x <= 2147483647
​
guild_folders
object[]
required

The folder structure for organizing guilds in the sidebar

Maximum array length: 200
​
custom_status
object
required

The custom status set by the user

​
afk_timeout
integer<int32>
required

The idle timeout in seconds before going AFK

Required range: 0 <= x <= 2147483647
​
time_format
enum<integer>
required

The preferred time format setting

Available options:
0,
1,
2
​
developer_mode
boolean
required

Whether developer mode is enabled

​
trusted_domains
string[]
required

List of trusted external link domains

Maximum array length: 1000
​
default_hide_muted_channels
boolean
required

Whether muted channels are hidden by default in new guilds

​
status_resets_at
string<date-time> | null

ISO8601 timestamp of when the status will reset

​
status_resets_to
string | null

The status to reset to after the scheduled reset