Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/fluxerapp/fluxer/llms.txt

Use this file to discover all available pages before exploring further.

Premium Resource

Fluxer Premium (also called Visionary) unlocks additional features and customization options.

Premium Types

Premium User Object

Premium status is included in the User object:
premium_type
integer | null
Premium subscription type (0, 1, or 2)
premium_since
ISO8601 timestamp | null
When the user first became premium
premium_until
ISO8601 timestamp | null
When the premium subscription expires (null for lifetime)
premium_will_cancel
boolean
Whether the subscription will cancel at period end
premium_billing_cycle
string | null
Billing cycle: “monthly”, “yearly”, or “lifetime”
premium_lifetime_sequence
integer | null
Lifetime subscriber number (e.g., #1, #42)

Premium Features

Profile Customization

Messaging

Guilds

Client Features

Storage & History

Pricing

Monthly Subscription

  • $9.99/month (USD)
  • Billed monthly
  • Cancel anytime
  • Features active while subscribed

Yearly Subscription

  • $99.99/year (USD)
  • Save 17% vs monthly
  • Billed annually
  • Cancel anytime, active until year end

Lifetime

  • $299.99 (USD, one-time)
  • Never expires
  • All premium features forever
  • Exclusive lifetime badge
  • Serial number badge (#1, #42, etc.)

Premium Badges

Premium subscribers receive badges on their profile:

Visionary Badge

Displays your premium status with:
  • Premium icon
  • Subscription start date (optional)
  • Lifetime sequence number (for lifetime subscribers)

Badge Privacy

Control badge visibility:
premium_badge_hidden
boolean
Hide the premium badge entirely
premium_badge_timestamp_hidden
boolean
Hide the “Premium since” timestamp
premium_badge_sequence_hidden
boolean
Hide the lifetime sequence number

Guild Perks

Guilds owned by premium users automatically receive:

Emoji & Sticker Slots

  • Base: 50 emoji slots, 5 sticker slots
  • With Premium Owner: 75 emoji slots, 8 sticker slots
  • With VISIONARY Feature: Unlimited emoji and stickers

Upload Limits

  • Base: Members can upload 25MB files
  • With Premium Owner: Members can upload 50MB files

Customization

  • Animated Icon: Guild icon can be animated (GIF)
  • Banner: Set a guild banner image
  • Invite Splash: Custom splash screen for invites
  • Vanity URL: Custom invite link

Premium Onboarding

New premium subscribers see an onboarding flow explaining features:
premium_onboarding_dismissed_at
ISO8601 timestamp | null
When the user dismissed premium onboarding
Dismiss onboarding:
POST /api/v1/users/@me/premium/dismiss-onboarding

Free Trial

Fluxer occasionally offers free premium trials:
  • 7-day trial for new users
  • Full access to premium features
  • No credit card required
  • Auto-expires after trial period
  • Can only use trial once per account

Premium Gifting

Gift premium to other users:
  1. Purchase a gift subscription via Billing
  2. Receive a unique gift code
  3. Send the code to the recipient
  4. Recipient redeems code for premium time
Gift options:
  • 1 month premium
  • 1 year premium
  • Custom duration (via support)

Endpoints

Get Premium Status

GET /api/v1/users/@me
Premium details are included in the user object.

Get Premium Features

GET /api/v1/premium/features
Returns a list of premium features and their availability. Response:
{
  "features": [
    {
      "id": "global_emojis",
      "name": "Global Emojis",
      "description": "Use custom emojis from any guild",
      "available": true
    },
    {
      "id": "animated_avatar",
      "name": "Animated Avatar",
      "description": "Upload GIF avatars",
      "available": true
    }
  ],
  "has_premium": true,
  "premium_type": 1
}

Get Premium Perks for Guild

GET /api/v1/guilds/{guild_id}/premium
Check what premium perks are active for a guild. Response:
{
  "owner_has_premium": true,
  "emoji_limit": 75,
  "sticker_limit": 8,
  "upload_limit": 52428800,
  "features": [
    "ANIMATED_ICON",
    "BANNER"
  ]
}

Dismiss Premium Onboarding

POST /api/v1/users/@me/premium/dismiss-onboarding
Mark premium onboarding as completed.

Update Badge Settings

PATCH /api/v1/users/@me/settings
Update premium badge visibility.
premium_badge_hidden
boolean
Hide premium badge
premium_badge_timestamp_hidden
boolean
Hide premium since timestamp
premium_badge_sequence_hidden
boolean
Hide lifetime sequence number

Premium Expiration

When premium expires:
  • Premium features are disabled immediately
  • Custom discriminator may be reset (if in use)
  • Animated avatars/banners become static
  • Guild perks removed if no other premium owner
  • Upload size reduced to free tier limits
  • Message history access restricted

Premium Refunds

See Billing for refund policies.

Premium Support

Premium subscribers get:
  • Priority support queue
  • Faster response times (typically <24h)
  • Dedicated premium support channel
  • Direct line to development team
Contact premium support:
  • Email: premium@fluxer.chat
  • In-app: Premium Support button in settings
  • Discord: #premium-support channel

Grandfathered Plans

Users who subscribed during early access or special promotions may have grandfathered pricing:
  • Locked-in lower rates
  • Maintains price as long as subscription remains active
  • Canceling forfeits grandfathered pricing
  • Billing - Manage subscriptions and payments
  • Users - User premium status fields
  • Guilds - Guild premium perks

Build docs developers (and LLMs) love