How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Discord

Discord Guilds API

The Guilds API from Discord — 45 operation(s) for guilds.

Documentation Provider Profile APIs.io OpenAPI GitHub

Discord Guilds API is one of 29 APIs that Discord publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Guilds. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 78 operations across 45 paths, and defines 206 schemas. It is described by OpenAPI 3.1.0, at version 10.

Requests are made against a single base URL, https://discord.com/api/v10.

78 operations 45 paths 206 schemas 11 DELETE35 GET15 PATCH12 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
10
Base URL
https://discord.com/api/v10
Authentication
HTTP Bearer
Contact
Discord Support
Terms of Service
View terms
Resource Areas
1

Authentication & Security 1

Discord Guilds API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BotToken). By default, every request must be authenticated.

  • BotToken — Bot token authentication

Paths & Operations 78

Across 45 paths, the API surfaces 78 operations — 11 DELETE, 35 GET, 15 PATCH, 12 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Guilds 78
POST
/guilds
create_guild body → 2014XX
GET
/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/users
list_guild_scheduled_event_users 6 params → 2004XX
GET
/guilds/{guild_id}/auto-moderation/rules/{rule_id}
get_auto_moderation_rule 2 params → 2004XX
DELETE
/guilds/{guild_id}/auto-moderation/rules/{rule_id}
delete_auto_moderation_rule 2 params → 2044XX
PATCH
/guilds/{guild_id}/auto-moderation/rules/{rule_id}
update_auto_moderation_rule 2 params body → 2004XX
GET
/guilds/{guild_id}/auto-moderation/rules
list_auto_moderation_rules 1 param → 2004XX
POST
/guilds/{guild_id}/auto-moderation/rules
create_auto_moderation_rule 1 param body → 2004XX
PATCH
/guilds/{guild_id}/voice-states/@me
update_self_voice_state 1 param body → 2044XX
GET
/guilds/{guild_id}/members/search
search_guild_members 3 params → 2004XX
GET
/guilds/{guild_id}/threads/active
get_active_guild_threads 1 param → 2004XX
PATCH
/guilds/{guild_id}/members/@me
update_my_guild_member 1 param body → 2004XX
PUT
/guilds/{guild_id}/members/{user_id}/roles/{role_id}
add_guild_member_role 3 params → 2044XX
DELETE
/guilds/{guild_id}/members/{user_id}/roles/{role_id}
delete_guild_member_role 3 params → 2044XX
GET
/guilds/templates/{code}
get_guild_template 1 param → 2004XX
POST
/guilds/templates/{code}
create_guild_from_template 1 param body → 2014XX
GET
/guilds/{guild_id}/new-member-welcome
get_guild_new_member_welcome 1 param → 2002044XX
GET
/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}
get_guild_scheduled_event 3 params → 2004XX
DELETE
/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}
delete_guild_scheduled_event 2 params → 2044XX
PATCH
/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}
update_guild_scheduled_event 2 params body → 2004XX
GET
/guilds/{guild_id}/scheduled-events
list_guild_scheduled_events 2 params → 2004XX
POST
/guilds/{guild_id}/scheduled-events
create_guild_scheduled_event 1 param body → 2004XX
GET
/guilds/{guild_id}/welcome-screen
get_guild_welcome_screen 1 param → 2004XX
PATCH
/guilds/{guild_id}/welcome-screen
update_guild_welcome_screen 1 param body → 2004XX
PATCH
/guilds/{guild_id}/voice-states/{user_id}
update_voice_state 2 params body → 2044XX
DELETE
/guilds/{guild_id}/integrations/{integration_id}
delete_guild_integration 2 params → 2044XX
GET
/guilds/{guild_id}/integrations
list_guild_integrations 1 param → 2004XX
GET
/guilds/{guild_id}/widget.json
get_guild_widget 1 param → 2004XX
GET
/guilds/{guild_id}/onboarding
get_guilds_onboarding 1 param → 2004XX
PUT
/guilds/{guild_id}/onboarding
put_guilds_onboarding 1 param body → 2004XX
GET
/guilds/{guild_id}/vanity-url
get_guild_vanity_url 1 param → 2004XX
GET
/guilds/{guild_id}/audit-logs
list_guild_audit_log_entries 7 params → 2004XX
GET
/guilds/{guild_id}/widget.png
get_guild_widget_png 2 params → 2004XX
PUT
/guilds/{guild_id}/templates/{code}
sync_guild_template 2 params → 2004XX
DELETE
/guilds/{guild_id}/templates/{code}
delete_guild_template 2 params → 2004XX
PATCH
/guilds/{guild_id}/templates/{code}
update_guild_template 2 params body → 2004XX
GET
/guilds/{guild_id}/templates
list_guild_templates 1 param → 2004XX
POST
/guilds/{guild_id}/templates
create_guild_template 1 param body → 2004XX
GET
/guilds/{guild_id}/stickers/{sticker_id}
get_guild_sticker 2 params → 2004XX
DELETE
/guilds/{guild_id}/stickers/{sticker_id}
delete_guild_sticker 2 params → 2044XX
PATCH
/guilds/{guild_id}/stickers/{sticker_id}
update_guild_sticker 2 params body → 2004XX
POST
/guilds/{guild_id}/bulk-ban
bulk_ban_users_from_guild 1 param body → 2004XX
GET
/guilds/{guild_id}/stickers
list_guild_stickers 1 param → 2004XX
POST
/guilds/{guild_id}/stickers
create_guild_sticker 1 param body → 2014XX
GET
/guilds/{guild_id}/webhooks
get_guild_webhooks 1 param → 2004XX
GET
/guilds/{guild_id}/channels
list_guild_channels 1 param → 2004XX
POST
/guilds/{guild_id}/channels
create_guild_channel 1 param body → 2014XX
PATCH
/guilds/{guild_id}/channels
bulk_update_guild_channels 1 param body → 2044XX
GET
/guilds/{guild_id}/members/{user_id}
get_guild_member 2 params → 2004XX
PUT
/guilds/{guild_id}/members/{user_id}
add_guild_member 2 params body → 2012044XX
DELETE
/guilds/{guild_id}/members/{user_id}
delete_guild_member 2 params → 2044XX
PATCH
/guilds/{guild_id}/members/{user_id}
update_guild_member 2 params body → 2002044XX
GET
/guilds/{guild_id}/members
list_guild_members 3 params → 2004XX
GET
/guilds/{guild_id}/preview
get_guild_preview 1 param → 2004XX
GET
/guilds/{guild_id}/invites
list_guild_invites 1 param → 2004XX
GET
/guilds/{guild_id}/regions
list_guild_voice_regions 1 param → 2004XX
GET
/guilds/{guild_id}/emojis/{emoji_id}
get_guild_emoji 2 params → 2004XX
DELETE
/guilds/{guild_id}/emojis/{emoji_id}
delete_guild_emoji 2 params → 2044XX
PATCH
/guilds/{guild_id}/emojis/{emoji_id}
update_guild_emoji 2 params body → 2004XX
GET
/guilds/{guild_id}/emojis
list_guild_emojis 1 param → 2004XX
POST
/guilds/{guild_id}/emojis
create_guild_emoji 1 param body → 2014XX
GET
/guilds/{guild_id}/widget
get_guild_widget_settings 1 param → 2004XX
PATCH
/guilds/{guild_id}/widget
update_guild_widget_settings 1 param body → 2004XX
DELETE
/guilds/{guild_id}/roles/{role_id}
delete_guild_role 2 params → 2044XX
PATCH
/guilds/{guild_id}/roles/{role_id}
update_guild_role 2 params body → 2004XX
GET
/guilds/{guild_id}/roles
list_guild_roles 1 param → 2004XX
POST
/guilds/{guild_id}/roles
create_guild_role 1 param body → 2004XX
PATCH
/guilds/{guild_id}/roles
bulk_update_guild_roles 1 param body → 2004XX
GET
/guilds/{guild_id}/prune
preview_prune_guild 3 params → 2004XX
POST
/guilds/{guild_id}/prune
prune_guild 1 param body → 2004XX
GET
/guilds/{guild_id}/bans/{user_id}
get_guild_ban 2 params → 2004XX
PUT
/guilds/{guild_id}/bans/{user_id}
ban_user_from_guild 2 params body → 2044XX
DELETE
/guilds/{guild_id}/bans/{user_id}
unban_user_from_guild 2 params → 2044XX
GET
/guilds/{guild_id}/bans
list_guild_bans 4 params → 2004XX
POST
/guilds/{guild_id}/mfa
set_guild_mfa_level 1 param body → 2004XX
GET
/guilds/{guild_id}
get_guild 2 params → 2004XX
DELETE
/guilds/{guild_id}
delete_guild 1 param → 2044XX
PATCH
/guilds/{guild_id}
update_guild 1 param body → 2004XX
GET
/applications/{application_id}/entitlements
Discord List entitlements
listEntitlements 7 params → 2004XX

Schemas 206

The contract defines 206 schemas that model the data the API accepts and returns. The most detailed are GuildWithCountsResponse (41 properties), GuildResponse (39 properties), GuildChannelResponse (24 properties), GuildPatchRequestPartial (22 properties). Each schema is shown below with its type and property counts.

AutomodTriggerType
integer
Int53Type
integer
IntegrationExpireBehaviorTypes
integer
ApplicationCommandUserOptionResponse
object
8 properties 3 required
EntityMetadataStageInstanceResponse
object
ApplicationCommandAttachmentOptionResponse
object
8 properties 3 required
MLSpamTriggerMetadataResponse
object
ApplicationTypes
integer
GuildAuditLogResponse
object
8 properties 8 required
FlagToChannelActionResponse
object
2 properties 2 required
SpamLinkRuleResponse
object
11 properties 8 required
PrivateGuildMemberResponse
object
13 properties 7 required
UserGuildOnboardingResponse
object
4 properties 4 required
DiscordIntegrationResponse
object
8 properties 4 required
AuditLogEntryResponse
object
7 properties 2 required
DefaultKeywordListTriggerMetadata
object
2 properties
ChannelFollowerWebhookResponse
object
10 properties 3 required
OnboardingPromptOptionRequest
object
8 properties 1 required
IntegrationExpireGracePeriodTypes
integer
StickerFormatTypes
integer
GuildSubscriptionIntegrationResponse
object
5 properties 2 required
Entitlement
object
9 properties
ChannelPermissionOverwriteRequest
object
4 properties 1 required
InviteApplicationResponse
object
21 properties 5 required
WidgetMember
object
13 properties 5 required
IconEmojiResponse
object
ApplicationCommandResponse
object
15 properties 6 required
MentionSpamTriggerMetadata
object
2 properties 1 required
SpamLinkTriggerMetadataResponse
object
ThreadMetadataResponse
object
6 properties 3 required
QuarantineUserActionMetadataResponse
object
GroupDMInviteResponse
object
8 properties 1 required
SnowflakeType
string
StickerTypes
integer
CreateGuildRequestRoleItem
object
7 properties 1 required
KeywordRuleResponse
object
11 properties 8 required
VanityURLErrorResponse
object
2 properties 2 required
ApplicationCommandOptionStringChoiceResponse
object
4 properties 2 required
MentionSpamUpsertRequest
object
8 properties 3 required
VoiceRegionResponse
object
5 properties 5 required
EmojiResponse
object
8 properties 7 required
ExternalScheduledEventResponse
object
17 properties 8 required
OnboardingPromptResponse
object
7 properties 7 required
Error
object
A single error, either for an API response or a specific field.
2 properties 2 required
StageScheduledEventCreateRequest
object
9 properties 4 required
GuildPruneResponse
object
1 property
QuarantineUserActionMetadata
object
WelcomeScreenPatchRequestPartial
object
3 properties
GuildCreateRequest
object
14 properties 1 required
WidgetSettingsResponse
object
2 properties 1 required
OnboardingPromptOptionResponse
object
6 properties 6 required
ResourceChannelResponse
object
5 properties 3 required
InviteChannelRecipientResponse
object
1 property 1 required
GuildHomeSettingsResponse
object
5 properties 2 required
GuildScheduledEventStatuses
integer
FlagToChannelActionMetadataResponse
object
1 property 1 required
GuildMFALevelResponse
object
1 property 1 required
UserResponse
object
11 properties 5 required
DefaultKeywordListUpsertRequest
object
8 properties 4 required
KeywordUpsertRequest
object
8 properties 3 required
EntityMetadataVoice
object
ChannelPermissionOverwrites
integer
ThreadsResponse
object
3 properties 2 required
ApplicationCommandOptionNumberChoiceResponse
object
4 properties 2 required
PartialGuildSubscriptionIntegrationResponse
object
4 properties 2 required
QuarantineUserActionResponse
object
2 properties 2 required
VoiceScheduledEventResponse
object
17 properties 7 required
AuditLogObjectChangeResponse
object
3 properties
DefaultKeywordListTriggerMetadataResponse
object
2 properties 2 required
GuildChannelResponse
object
24 properties 6 required
GuildMFALevel
integer
PrivateChannelResponse
object
6 properties 4 required
WebhookSourceGuildResponse
object
3 properties 2 required
MentionSpamTriggerMetadataResponse
object
1 property 1 required
AutomodActionType
integer
BulkBanUsersResponse
object
2 properties 2 required
WidgetResponse
object
6 properties 5 required
AccountResponse
object
2 properties 1 required
BlockMessageAction
object
2 properties 1 required
EntityMetadataExternalResponse
object
1 property 1 required
GuildWelcomeScreenResponse
object
2 properties 1 required
MentionSpamRuleResponse
object
11 properties 8 required
ApplicationCommandOptionIntegerChoiceResponse
object
4 properties 2 required
ScheduledEventUserResponse
object
4 properties 2 required
GuildTemplateResponse
object
11 properties 8 required
ApplicationCommandMentionableOptionResponse
object
8 properties 3 required
GuildRoleResponse
object
12 properties 8 required
ThreadSortOrder
integer
UpdateGuildOnboardingRequest
object
4 properties
GuildMemberResponse
object
12 properties 7 required
GuildTemplateRoleResponse
object
8 properties 6 required
FlagToChannelAction
object
2 properties 2 required
Snowflake
string
Discord unique ID represented as a string
WelcomeMessageResponse
object
2 properties 2 required
UpdateOnboardingPromptRequest
object
7 properties 3 required
ApplicationCommandStringOptionResponse
object
12 properties 3 required
WidgetChannel
object
3 properties 3 required
GuildTemplateChannelTags
object
4 properties 1 required
ThreadAutoArchiveDuration
integer
DefaultReactionEmojiResponse
object
2 properties
AutomodEventType
integer
QuarantineUserAction
object
2 properties 1 required
FriendInviteResponse
object
12 properties 1 required
OAuth2Scopes
string
VanityURLResponse
object
3 properties 1 required
ApplicationCommandBooleanOptionResponse
object
8 properties 3 required
UserNotificationSettings
integer
VideoQualityModes
integer
PremiumGuildTiers
integer
GuildOnboardingMode
integer
InviteTargetTypes
integer
ForumTagResponse
object
5 properties 3 required
ApplicationCommandNumberOptionResponse
object
12 properties 3 required
VerificationLevels
integer
BlockMessageActionMetadataResponse
object
1 property
GuildScheduledEventEntityTypes
integer
InviteTypes
integer
DefaultKeywordListUpsertRequestPartial
object
8 properties
PartialDiscordIntegrationResponse
object
5 properties 3 required
EntityMetadataVoiceResponse
object
AutomodKeywordPresetType
integer
ChannelPermissionOverwriteResponse
object
4 properties 4 required
ApplicationCommandRoleOptionResponse
object
8 properties 3 required
KeywordUpsertRequestPartial
object
8 properties
StageScheduledEventPatchRequestPartial
object
10 properties
ErrorDetails
ThreadMemberResponse
object
5 properties 4 required
FlagToChannelActionMetadata
object
1 property 1 required
GuildRoleTagsResponse
object
6 properties
WidgetUserDiscriminator
string
ApplicationCommandOptionType
integer
CreateGuildRequestChannelItem
object
19 properties 1 required
UserCommunicationDisabledActionMetadata
object
1 property
ThreadResponse
object
21 properties 9 required
GuildPatchRequestPartial
object
22 properties
MLSpamTriggerMetadata
object
NewMemberActionResponse
object
6 properties 4 required
GuildStickerResponse
object
9 properties 6 required
UserCommunicationDisabledActionResponse
object
2 properties 2 required
InnerErrors
object
1 property 1 required
InviteGuildResponse
object
12 properties 3 required
BlockMessageActionResponse
object
2 properties 2 required
GuildExplicitContentFilterTypes
integer
GuildFeatures
string
ExternalScheduledEventPatchRequestPartial
object
10 properties
GuildNSFWContentLevel
integer
InviteStageInstanceResponse
object
4 properties 1 required
ApplicationOAuth2InstallParamsResponse
object
2 properties 2 required
AuditLogActionTypes
integer
PrivateGroupChannelResponse
object
11 properties 4 required
GuildTemplateSnapshotResponse
object
13 properties 9 required
ExternalConnectionIntegrationResponse
object
14 properties 3 required
ApplicationCommandChannelOptionResponse
object
9 properties 3 required
MLSpamUpsertRequestPartial
object
8 properties
MLSpamRuleResponse
object
11 properties 8 required
ExternalScheduledEventCreateRequest
object
9 properties 5 required
UserAvatarDecorationResponse
object
IntegrationApplicationResponse
object
8 properties 3 required
ApplicationCommandSubcommandGroupOptionResponse
object
9 properties 3 required
CreateGuildChannelRequest
object
18 properties 1 required
UserCommunicationDisabledAction
object
2 properties 2 required
GuildPreviewResponse
object
12 properties 7 required
GuildWithCountsResponse
object
41 properties 21 required
WidgetImageStyles
string
KeywordTriggerMetadata
object
3 properties
WebhookTypes
integer
GuildBanResponse
object
2 properties 1 required
GuildWelcomeChannel
object
4 properties 2 required
StageScheduledEventResponse
object
17 properties 7 required
VoiceScheduledEventCreateRequest
object
9 properties 4 required
PartialExternalConnectionIntegrationResponse
object
4 properties 2 required
GuildWelcomeScreenChannelResponse
object
4 properties 2 required
AvailableLocalesEnum
string
BlockMessageActionMetadata
object
1 property
GuildResponse
object
39 properties 21 required
OnboardingPromptType
integer
ForumLayout
integer
CreateOrUpdateThreadTagRequest
object
4 properties 1 required
ApplicationCommandIntegerOptionResponse
object
12 properties 3 required
ErrorResponse
object
Errors object returned by the Discord API
UserCommunicationDisabledActionMetadataResponse
object
1 property 1 required
MLSpamUpsertRequest
object
8 properties 3 required
UpdateDefaultReactionEmojiRequest
object
2 properties
GuildTemplateChannelResponse
object
20 properties 7 required
VoiceScheduledEventPatchRequestPartial
object
10 properties
NewMemberActionType
integer
IntegrationTypes
string
GuildInviteResponse
object
21 properties 1 required
ApplicationIncomingWebhookResponse
object
8 properties 3 required
InviteChannelResponse
object
5 properties 2 required
KeywordTriggerMetadataResponse
object
3 properties 3 required
ScheduledEventResponse
object
16 properties 7 required
DefaultKeywordRuleResponse
object
11 properties 8 required
ApplicationCommandType
integer
WebhookSourceChannelResponse
object
2 properties 2 required
EntityMetadataExternal
object
1 property 1 required
GuildOnboardingResponse
object
4 properties 4 required
WidgetActivity
object
1 property 1 required
EntityMetadataStageInstance
object
GuildIncomingWebhookResponse
object
10 properties 3 required
ApplicationCommandSubcommandOptionResponse
object
9 properties 3 required
GuildScheduledEventPrivacyLevels
integer
AfkTimeouts
integer
SettingsEmojiResponse
object
3 properties
ChannelTypes
integer
MentionSpamUpsertRequestPartial
object
8 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

discord-guilds-api-openapi.yml Raw ↑

Other APIs Discord publishes across the network.

Discord Gateway API
AE Profile APIs.io
Discord Interactions API
AE Profile APIs.io
Discord OAuth2 API
AE Profile APIs.io
Discord Webhook Events API
AE Profile APIs.io
Discord Embedded App SDK
AE Profile APIs.io
Discord Voice API
AE Profile APIs.io
Discord Social SDK
AE Profile APIs.io
Discord Application Commands API
AE Profile APIs.io
Discord Applications API
AE Profile APIs.io
Discord Audit Log API
AE Profile APIs.io
Discord Auto Moderation API
AE Profile APIs.io
Discord Channels API
AE Profile APIs.io
#Guilds
← Back to D APIs
API Details
ID
discord:discord-guilds-api
Base URL
https://discord.com/api/v10
Docs
https://discord.com/developers/docs/reference
Provider
Discord
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=discord-guilds-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/discord-guilds-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Discord Guilds API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.