Skip to main content
PATCH
/
guilds
/
{guild_id}
Update guild settings
curl --request PATCH \
  --url https://api.fluxer.app/v1/guilds/{guild_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "icon": "aSDinaTvuI8gbWludGxpZnk=",
  "system_channel_id": "<string>",
  "system_channel_flags": 1073741823,
  "afk_channel_id": "<string>",
  "afk_timeout": 1830,
  "default_message_notifications": 0,
  "verification_level": 0,
  "mfa_level": 0,
  "nsfw_level": 0,
  "explicit_content_filter": 0,
  "banner": "aSDinaTvuI8gbWludGxpZnk=",
  "splash": "aSDinaTvuI8gbWludGxpZnk=",
  "embed_splash": "aSDinaTvuI8gbWludGxpZnk=",
  "splash_card_alignment": 0,
  "features": [
    "<string>"
  ],
  "message_history_cutoff": "2023-11-07T05:31:56Z",
  "password": "<string>",
  "mfa_method": "totp",
  "mfa_code": "<string>",
  "webauthn_response": {},
  "webauthn_challenge": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "splash_card_alignment": 0,
  "owner_id": "<string>",
  "system_channel_flags": 1073741823,
  "afk_timeout": 1073741823,
  "features": [
    "<string>"
  ],
  "verification_level": 0,
  "mfa_level": 0,
  "nsfw_level": 0,
  "explicit_content_filter": 0,
  "default_message_notifications": 0,
  "disabled_operations": 1073741823,
  "icon": "<string>",
  "banner": "<string>",
  "banner_width": 1073741823,
  "banner_height": 1073741823,
  "splash": "<string>",
  "splash_width": 1073741823,
  "splash_height": 1073741823,
  "embed_splash": "<string>",
  "embed_splash_width": 1073741823,
  "embed_splash_height": 1073741823,
  "vanity_url_code": "<string>",
  "system_channel_id": "<string>",
  "rules_channel_id": "<string>",
  "afk_channel_id": "<string>",
  "message_history_cutoff": "2023-11-07T05:31:56Z",
  "permissions": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
guild_id
string<snowflake>
required

The ID of the guild

Pattern: ^(0|[1-9][0-9]*)$

Body

application/json
​
name
string

The name of the guild (1-100 characters)

​
icon
string<byte> | null

Base64-encoded image data for the guild icon

​
system_channel_id
string<snowflake> | null

The ID of the channel where system messages are sent

Pattern: ^(0|[1-9][0-9]*)$
​
system_channel_flags
integer<int32>

System channel message flags

Required range: 0 <= x <= 2147483647
​
afk_channel_id
string<snowflake> | null

The ID of the AFK voice channel

Pattern: ^(0|[1-9][0-9]*)$
​
afk_timeout
integer<int32>

AFK timeout in seconds (60-3600) before moving users to the AFK channel

Required range: 60 <= x <= 3600
​
default_message_notifications
enum<integer>

Default notification level for new members

Available options:
0,
1
​
verification_level
enum<integer>

Required verification level for members to participate

Available options:
0,
1,
2,
3,
4
​
mfa_level
enum<integer>

Required MFA level for moderation actions

Available options:
0,
1
​
nsfw_level
enum<integer>

The NSFW level of the guild

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

Level of content filtering for explicit media

Available options:
0,
1,
2
​
banner
string<byte> | null

Base64-encoded image data for the guild banner

​
splash
string<byte> | null

Base64-encoded image data for the guild splash screen

​
embed_splash
string<byte> | null

Base64-encoded image data for the embedded invite splash

​
splash_card_alignment
enum<integer>

Alignment of the splash card (center, left, or right)

Available options:
0,
1,
2
​
features
string[]

Array of guild feature strings

​
message_history_cutoff
string<date-time> | null

ISO8601 timestamp controlling how far back members without Read Message History can access messages. Set to null to disable historical access.

​
password
string
Required string length: 8 - 256
​
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 for this guild

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

The name of the guild

​
splash_card_alignment
enum<integer>
required

The alignment of the splash card

Available options:
0,
1,
2
​
owner_id
string
required

The ID of the guild owner

Pattern: ^(0|[1-9][0-9]*)$
​
system_channel_flags
integer<int32>
required

System channel message flags

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

AFK timeout in seconds before moving users to the AFK channel

Required range: 0 <= x <= 2147483647
​
features
string[]
required

Array of guild feature flags

Maximum array length: 100

A guild feature flag Known values: ANIMATED_ICON, ANIMATED_BANNER, BANNER, DETACHED_BANNER, INVITE_SPLASH, INVITES_DISABLED, TEXT_CHANNEL_FLEXIBLE_NAMES, MORE_EMOJI, MORE_STICKERS, UNLIMITED_EMOJI, UNLIMITED_STICKERS, EXPRESSION_PURGE_ALLOWED, VANITY_URL, VERIFIED, VIP_VOICE, UNAVAILABLE_FOR_EVERYONE, UNAVAILABLE_FOR_EVERYONE_BUT_STAFF, VISIONARY, OPERATOR, LARGE_GUILD_OVERRIDE, VERY_LARGE_GUILD (other values allowed)

​
verification_level
enum<integer>
required

Required verification level for members to participate

Available options:
0,
1,
2,
3,
4
​
mfa_level
enum<integer>
required

Required MFA level for moderation actions

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

The NSFW level of the guild

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

Level of content filtering for explicit media

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

Default notification level for new members

Available options:
0,
1
​
disabled_operations
integer<int32>
required

Bitmask of disabled guild operations

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

The hash of the guild icon

​
banner
string | null

The hash of the guild banner

​
banner_width
integer<int32> | null

The width of the guild banner in pixels

Required range: 0 <= x <= 2147483647
​
banner_height
integer<int32> | null

The height of the guild banner in pixels

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

The hash of the guild splash screen

​
splash_width
integer<int32> | null

The width of the guild splash in pixels

Required range: 0 <= x <= 2147483647
​
splash_height
integer<int32> | null

The height of the guild splash in pixels

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

The hash of the embedded invite splash

​
embed_splash_width
integer<int32> | null

The width of the embedded invite splash in pixels

Required range: 0 <= x <= 2147483647
​
embed_splash_height
integer<int32> | null

The height of the embedded invite splash in pixels

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

The vanity URL code for the guild

​
system_channel_id
string<snowflake> | null

The ID of the channel where system messages are sent

Pattern: ^(0|[1-9][0-9]*)$
​
rules_channel_id
string<snowflake> | null

The ID of the rules channel

Pattern: ^(0|[1-9][0-9]*)$
​
afk_channel_id
string<snowflake> | null

The ID of the AFK voice channel

Pattern: ^(0|[1-9][0-9]*)$
​
message_history_cutoff
string<date-time> | null

ISO8601 timestamp controlling how far back members without Read Message History can access messages. When null, no historical access is allowed.

​
permissions
string<int64> | null

The current user permissions in this guild

Pattern: ^[0-9]+$