Skip to main content
PATCH
/
users
/
@me
Update current user profile
curl --request PATCH \
  --url https://api.fluxer.app/v1/users/@me \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "<string>",
  "discriminator": "<string>",
  "global_name": "<string>",
  "email": "jsmith@example.com",
  "new_password": "<string>",
  "password": "<string>",
  "avatar": "aSDinaTvuI8gbWludGxpZnk=",
  "banner": "aSDinaTvuI8gbWludGxpZnk=",
  "bio": "<string>",
  "pronouns": "<string>",
  "accent_color": 8388607,
  "premium_badge_hidden": true,
  "premium_badge_masked": true,
  "premium_badge_timestamp_hidden": true,
  "premium_badge_sequence_hidden": true,
  "premium_enabled_override": true,
  "has_dismissed_premium_onboarding": true,
  "has_unread_gift_inventory": true,
  "used_mobile_client": true,
  "email_token": "<string>",
  "mfa_method": "totp",
  "mfa_code": "<string>",
  "webauthn_response": {},
  "webauthn_challenge": "<string>"
}
'
{
  "id": "<string>",
  "username": "<string>",
  "discriminator": "<string>",
  "global_name": "<string>",
  "avatar": "<string>",
  "avatar_color": 1073741823,
  "flags": 1073741823,
  "is_staff": true,
  "acls": [
    "<string>"
  ],
  "traits": [
    "<string>"
  ],
  "email": "<string>",
  "phone": "<string>",
  "bio": "<string>",
  "pronouns": "<string>",
  "accent_color": 1073741823,
  "banner": "<string>",
  "banner_color": 1073741823,
  "mfa_enabled": true,
  "verified": true,
  "premium_type": 0,
  "premium_since": "<string>",
  "premium_until": "<string>",
  "premium_will_cancel": true,
  "premium_billing_cycle": "<string>",
  "premium_lifetime_sequence": 1073741823,
  "premium_badge_hidden": true,
  "premium_badge_masked": true,
  "premium_badge_timestamp_hidden": true,
  "premium_badge_sequence_hidden": true,
  "premium_purchase_disabled": true,
  "premium_enabled_override": true,
  "password_last_changed_at": "<string>",
  "required_actions": [
    "<string>"
  ],
  "nsfw_allowed": true,
  "has_dismissed_premium_onboarding": true,
  "has_ever_purchased": true,
  "has_unread_gift_inventory": true,
  "unread_gift_inventory_count": 1073741823,
  "used_mobile_client": true,
  "pending_bulk_message_deletion": {
    "scheduled_at": "<string>",
    "channel_count": 1073741823,
    "message_count": 1073741823
  },
  "bot": true,
  "system": true,
  "email_bounced": true,
  "authenticator_types": [
    0
  ]
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
username
string
Required string length: 1 - 32
Pattern: ^[a-zA-Z0-9_]+$
​
discriminator
string

The 4-digit discriminator tag

Pattern: ^\d{1,4}$
​
global_name
string | null

The display name shown to other users

​
email
string<email>
​
new_password
string
Required string length: 8 - 256
​
password
string
Required string length: 8 - 256
​
avatar
string<byte> | null

Base64-encoded avatar image

​
banner
string<byte> | null

Base64-encoded profile banner image

​
bio
string | null

User biography text (max 320 characters)

​
pronouns
string | null

User pronouns (max 40 characters)

​
accent_color
integer<int32> | null

Profile accent color as integer

Required range: 0 <= x <= 16777215
​
premium_badge_hidden
boolean

Whether to hide the premium badge

​
premium_badge_masked
boolean

Whether to mask the premium badge

​
premium_badge_timestamp_hidden
boolean

Whether to hide premium badge timestamp

​
premium_badge_sequence_hidden
boolean

Whether to hide premium badge sequence

​
premium_enabled_override
boolean

Override premium enabled state

​
has_dismissed_premium_onboarding
boolean

Whether user dismissed premium onboarding

​
has_unread_gift_inventory
boolean

Whether user has unread gifts

​
used_mobile_client
boolean

Whether user has used mobile client

​
email_token
string

Email change token for updating email

​
mfa_method
enum<string>

MFA method to use for verification

Available options:
totp,
sms,
webauthn
​
mfa_code
string

MFA verification code from authenticator app or SMS

​
webauthn_response
object

WebAuthn authentication response

​
webauthn_challenge
string

WebAuthn challenge string

Response

Success

​
id
string
required

The unique identifier (snowflake) for this user

Pattern: ^(0|[1-9][0-9]*)$
​
username
string
required

The username of the user, not unique across the platform

​
discriminator
string
required

The four-digit discriminator tag of the user

​
global_name
string | null
required

The display name of the user, if set

​
avatar
string | null
required

The hash of the user avatar image

​
avatar_color
integer<int32> | null
required

The dominant avatar color of the user as an integer

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

The public flags on the user account

Required range: 0 <= x <= 2147483647
​
is_staff
boolean
required

Whether the user has staff permissions

​
acls
string[]
required

Access control list entries for the user

Maximum array length: 100
​
traits
string[]
required

Special traits assigned to the user account

Maximum array length: 100
​
email
string | null
required

The email address associated with the account

​
phone
string | null
required

The phone number associated with the account

​
bio
string | null
required

The user biography text

​
pronouns
string | null
required

The preferred pronouns of the user

​
accent_color
integer<int32> | null
required

The user-selected accent color as an integer

Required range: 0 <= x <= 2147483647
​
banner
string | null
required

The hash of the user profile banner image

​
banner_color
integer<int32> | null
required

The default banner color if no custom banner is set

Required range: 0 <= x <= 2147483647
​
mfa_enabled
boolean
required

Whether multi-factor authentication is enabled

​
verified
boolean
required

Whether the email address has been verified

​
premium_type
enum<integer> | null
required

The type of premium subscription

Available options:
0,
1,
2
​
premium_since
string | null
required

ISO8601 timestamp of when premium was first activated

​
premium_until
string | null
required

ISO8601 timestamp of when the current premium period ends

​
premium_will_cancel
boolean
required

Whether premium is set to cancel at the end of the billing period

​
premium_billing_cycle
string | null
required

The billing cycle for the premium subscription

​
premium_lifetime_sequence
integer<int32> | null
required

The sequence number for lifetime premium subscribers

Required range: 0 <= x <= 2147483647
​
premium_badge_hidden
boolean
required

Whether the premium badge is hidden on the profile

​
premium_badge_masked
boolean
required

Whether the premium badge shows a masked appearance

​
premium_badge_timestamp_hidden
boolean
required

Whether the premium start timestamp is hidden

​
premium_badge_sequence_hidden
boolean
required

Whether the lifetime sequence number is hidden

​
premium_purchase_disabled
boolean
required

Whether premium purchases are disabled for this account

​
premium_enabled_override
boolean
required

Whether premium features are enabled via override

​
password_last_changed_at
string | null
required

ISO8601 timestamp of the last password change

​
required_actions
string[] | null
required

Actions the user must complete before full access

Maximum array length: 20
​
nsfw_allowed
boolean
required

Whether the user is allowed to view NSFW content

​
has_dismissed_premium_onboarding
boolean
required

Whether the user has dismissed the premium onboarding flow

​
has_ever_purchased
boolean
required

Whether the user has ever made a purchase

​
has_unread_gift_inventory
boolean
required

Whether there are unread items in the gift inventory

​
unread_gift_inventory_count
integer<int32>
required

The number of unread gift inventory items

Required range: 0 <= x <= 2147483647
​
used_mobile_client
boolean
required

Whether the user has ever used the mobile client

​
pending_bulk_message_deletion
object
required

Information about a pending bulk message deletion request

​
bot
boolean

Whether the user is a bot account

​
system
boolean

Whether the user is an official system user

​
email_bounced
boolean

Whether the current email address is marked as bounced by the mail provider

​
authenticator_types
enum<integer>[]

The types of authenticators configured for MFA

Maximum array length: 10

Authenticator type

Available options:
0,
1,
2