Sign in
Guilds

Update guild settings

Requires manage_guild permission. Updates guild name, description, icon, banner, and other configuration options.

patch/guilds/{guild_id}

Path parameters

guild_idstring snowflake required

The ID of the guild

Request body

namestring

The name of the guild (1-100 characters)

iconstring byte

Base64-encoded image data

system_channel_idstring snowflake
system_channel_flagsinteger

System channel message flags

afk_channel_idstring snowflake
afk_timeoutinteger

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

default_message_notifications0 | 1

Default notification level for new members

verification_level0 | 1 | 2 | 3 | 4

Required verification level for members

mfa_level0 | 1

Required MFA level for moderation actions

nsfw_level0 | 3

The NSFW level of the guild

nsfwboolean

Whether the guild is marked as adult (18+) content

content_warning_level0 | 1

The content warning level for a guild, category, or channel

content_warning_textstring nullable

Custom guild-wide content warning text (max 200 characters); null falls back to a localized default

explicit_content_filter0 | 1 | 2

Level of content filtering for explicit media

bannerstring byte

Base64-encoded image data

splashstring byte

Base64-encoded image data

embed_splashstring byte

Base64-encoded image data

splash_card_alignment0 | 1 | 2

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

featuresGuildFeatureSchema[]

Complete desired feature set for the guild. Only user-toggleable features may differ from the current set; non-toggleable features must be preserved as-is.

message_history_cutoffstring date-time nullable

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

passwordstring
mfa_method'totp' | 'webauthn'

MFA method to use for verification

mfa_codestring

MFA verification code from an authenticator app

webauthn_responseobject

WebAuthn authentication response

webauthn_challengestring

WebAuthn challenge string

Response

Success

idstring required

The unique identifier for this guild

namestring required

The name of the guild

iconstring nullable

The hash of the guild icon

bannerstring nullable

The hash of the guild banner

banner_widthinteger
banner_heightinteger
splashstring nullable

The hash of the guild splash screen

splash_widthinteger
splash_heightinteger
splash_card_alignment0 | 1 | 2 required

The alignment of the splash card

embed_splashstring nullable

The hash of the embedded invite splash

embed_splash_widthinteger
embed_splash_heightinteger
vanity_url_codestring nullable

The vanity URL code for the guild

owner_idstring required

The ID of the guild owner

system_channel_idstring snowflake
system_channel_flagsinteger required

System channel message flags

rules_channel_idstring snowflake
afk_channel_idstring snowflake
afk_timeoutinteger required

AFK timeout in seconds before moving users to the AFK channel

featuresGuildFeatureSchema[] required

Array of guild feature flags

verification_level0 | 1 | 2 | 3 | 4 required

Required verification level for members

mfa_level0 | 1 required

Required MFA level for moderation actions

nsfw_level0 | 3 required

The NSFW level of the guild

nsfwboolean required

Whether the guild is marked as adult (18+) content

content_warning_level0 | 1 required

The content warning level for a guild, category, or channel

content_warning_textstring nullable

Custom guild-wide content warning text; null falls back to a localized default

explicit_content_filter0 | 1 | 2 required

Level of content filtering for explicit media

default_message_notifications0 | 1 required

Default notification level for new members

disabled_operationsinteger required

Bitmask of disabled guild operations

message_history_cutoffstring date-time nullable

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

permissionsstring int64

The current user permissions in this guild when available

member_countinteger
online_countinteger
approximate_member_countinteger
approximate_presence_countinteger

Changes