Developers

API endpoints

Every endpoint Discord documents for apps and bots, taken from its public OpenAPI spec (spec 300292), plus the ones that are only in the preview file so far. Looking for what the client itself calls? That's the client route table.

openapi.json Changes

Endpoints 250 107 GET · 45 POST · 25 PUT · 33 PATCH · 40 DELETE

Preview only 0 in openapi_preview.json

Work with OAuth2 41 22 also work without a token

Deprecated 0 flagged in the spec

		Request / response	Auth
GET	/applications/{application_id}get_application	out PrivateApplicationResponse	bot
PATCH	/applications/{application_id}update_application	in ApplicationFormPartialout PrivateApplicationResponse	bot
GET	/applications/{application_id}/activity-instances/{instance_id}applications_get_activity_instance	out EmbeddedActivityInstance	bot
POST	/applications/{application_id}/attachmentupload_application_attachment	in multipart/form-data objectout ActivitiesAttachmentResponse	botoauth2
GET	/applications/{application_id}/commandslist_application_commands	out ApplicationCommandResponse[]\|null	botoauth2 applications.commands.update
PUT	/applications/{application_id}/commandsbulk_set_application_commands	in ApplicationCommandUpdateRequest[]\|nullout ApplicationCommandResponse[]\|null	botoauth2 applications.commands.update
POST	/applications/{application_id}/commandscreate_application_command	in ApplicationCommandCreateRequestout ApplicationCommandResponse	botoauth2 applications.commands.update
GET	/applications/{application_id}/commands/{command_id}get_application_command	out ApplicationCommandResponse	botoauth2 applications.commands.update
PATCH	/applications/{application_id}/commands/{command_id}update_application_command	in ApplicationCommandPatchRequestPartialout ApplicationCommandResponse	botoauth2 applications.commands.update
DELETE	/applications/{application_id}/commands/{command_id}delete_application_command	out 204	botoauth2 applications.commands.update
GET	/applications/{application_id}/emojislist_application_emojis	out ListApplicationEmojisResponse	bot
POST	/applications/{application_id}/emojiscreate_application_emoji	in objectout EmojiResponse	bot
GET	/applications/{application_id}/emojis/{emoji_id}get_application_emoji	out EmojiResponse	bot
PATCH	/applications/{application_id}/emojis/{emoji_id}update_application_emoji	in objectout EmojiResponse	bot
DELETE	/applications/{application_id}/emojis/{emoji_id}delete_application_emoji	out 204	bot
GET	/applications/{application_id}/entitlementsget_entitlements	out EntitlementResponse[]	botoauth2 applications.entitlements
POST	/applications/{application_id}/entitlementscreate_entitlement	in CreateEntitlementRequestDataout EntitlementResponse	bot
GET	/applications/{application_id}/entitlements/{entitlement_id}get_entitlement	out EntitlementResponse	botoauth2 applications.entitlements
DELETE	/applications/{application_id}/entitlements/{entitlement_id}delete_entitlement	out 204	botoauth2 applications.entitlements
POST	/applications/{application_id}/entitlements/{entitlement_id}/consumeconsume_entitlement	out 204	botoauth2 applications.entitlements
GET	/applications/{application_id}/guilds/{guild_id}/commandslist_guild_application_commands	out ApplicationCommandResponse[]\|null	botoauth2 applications.commands.update
PUT	/applications/{application_id}/guilds/{guild_id}/commandsbulk_set_guild_application_commands	in ApplicationCommandUpdateRequest[]\|nullout ApplicationCommandResponse[]\|null	botoauth2 applications.commands.update
POST	/applications/{application_id}/guilds/{guild_id}/commandscreate_guild_application_command	in ApplicationCommandCreateRequestout ApplicationCommandResponse	botoauth2 applications.commands.update
GET	/applications/{application_id}/guilds/{guild_id}/commands/{command_id}get_guild_application_command	out ApplicationCommandResponse	botoauth2 applications.commands.update
PATCH	/applications/{application_id}/guilds/{guild_id}/commands/{command_id}update_guild_application_command	in ApplicationCommandPatchRequestPartialout ApplicationCommandResponse	botoauth2 applications.commands.update
DELETE	/applications/{application_id}/guilds/{guild_id}/commands/{command_id}delete_guild_application_command	out 204	botoauth2 applications.commands.update
GET	/applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissionsget_guild_application_command_permissions	out CommandPermissionsResponse	botoauth2 applications.commands.permissions.update
PUT	/applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissionsset_guild_application_command_permissions	in objectout CommandPermissionsResponse	botoauth2 applications.commands.permissions.update
GET	/applications/{application_id}/guilds/{guild_id}/commands/permissionslist_guild_application_command_permissions	out CommandPermissionsResponse[]	botoauth2 applications.commands.permissions.update
GET	/applications/{application_id}/role-connections/metadataget_application_role_connections_metadata	out ApplicationRoleConnectionsMetadataItemResponse[]\|null	bot
PUT	/applications/{application_id}/role-connections/metadataupdate_application_role_connections_metadata	in ApplicationRoleConnectionsMetadataItemRequest[]\|nullout ApplicationRoleConnectionsMetadataItemResponse[]\|null	bot
GET	/applications/@meget_my_application	out PrivateApplicationResponse	bot
PATCH	/applications/@meupdate_my_application	in ApplicationFormPartialout PrivateApplicationResponse	bot
GET	/channels/{channel_id}get_channel	out GuildChannelResponse \| PrivateChannelResponse \| PrivateGroupChannelResponse \| ThreadRespo…	bot
PATCH	/channels/{channel_id}update_channel	in UpdateDMRequestPartial \| UpdateGroupDMRequestPartial \| UpdateGuildChannelRequestPartial \|…out GuildChannelResponse \| PrivateChannelResponse \| PrivateGroupChannelResponse \| ThreadRespo…	bot
DELETE	/channels/{channel_id}delete_channel	out GuildChannelResponse \| PrivateChannelResponse \| PrivateGroupChannelResponse \| ThreadRespo…	bot
POST	/channels/{channel_id}/followersfollow_channel	in objectout ChannelFollowerResponse	bot
GET	/channels/{channel_id}/inviteslist_channel_invites	out ((FriendInviteResponse \| GroupDMInviteResponse \| GuildInviteResponse)\|null)[]\|null	bot
POST	/channels/{channel_id}/invitescreate_channel_invite	in CreateGroupDMInviteRequest \| CreateGuildInviteRequest, application/x-www-form-urlencoded CreateGroupDMInviteRequest \| CreateGuildInviteRequest, multipart/form-data CreateGroupDMInviteRequest \| CreateGuildInviteRequest & objectout FriendInviteResponse \| GroupDMInviteResponse \| GuildInviteResponse	bot
GET	/channels/{channel_id}/messageslist_messages	out MessageResponse[]\|null	botoauth2
POST	/channels/{channel_id}/messagescreate_message	in MessageCreateRequest, application/x-www-form-urlencoded MessageCreateRequest, multipart/form-data MessageCreateRequest & objectout MessageResponse	bot
GET	/channels/{channel_id}/messages/{message_id}get_message	out MessageResponse	bot
PATCH	/channels/{channel_id}/messages/{message_id}update_message	in MessageEditRequestPartial, application/x-www-form-urlencoded MessageEditRequestPartial, multipart/form-data MessageEditRequestPartial & objectout MessageResponse	bot
DELETE	/channels/{channel_id}/messages/{message_id}delete_message	out 204	bot
POST	/channels/{channel_id}/messages/{message_id}/crosspostcrosspost_message	out MessageResponse	bot
DELETE	/channels/{channel_id}/messages/{message_id}/reactionsdelete_all_message_reactions	out 204	bot
GET	/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}list_message_reactions_by_emoji	out UserResponse[]	bot
DELETE	/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}delete_all_message_reactions_by_emoji	out 204	bot
DELETE	/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/{user_id}delete_user_message_reaction	out 204	bot
PUT	/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/@meadd_my_message_reaction	out 204	bot
DELETE	/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/@medelete_my_message_reaction	out 204	bot
POST	/channels/{channel_id}/messages/{message_id}/threadscreate_thread_from_message	in CreateTextThreadWithMessageRequestout ThreadResponse	bot
POST	/channels/{channel_id}/messages/bulk-deletebulk_delete_messages	in objectout 204	bot
GET	/channels/{channel_id}/messages/pinslist_pins	out PinnedMessagesResponse	bot
PUT	/channels/{channel_id}/messages/pins/{message_id}create_pin	out 204	bot
DELETE	/channels/{channel_id}/messages/pins/{message_id}delete_pin	out 204	bot
PUT	/channels/{channel_id}/permissions/{overwrite_id}set_channel_permission_overwrite	in objectout 204	bot
DELETE	/channels/{channel_id}/permissions/{overwrite_id}delete_channel_permission_overwrite	out 204	bot
GET	/channels/{channel_id}/permissions/member/{user_id}get_channel_member_permissions	out PermissionsResponse	bot	12d ago
GET	/channels/{channel_id}/permissions/role/{role_id}get_channel_role_permissions	out PermissionsResponse	bot	12d ago
GET	/channels/{channel_id}/pinsdeprecated_list_pins	out MessageResponse[]\|null	bot
PUT	/channels/{channel_id}/pins/{message_id}deprecated_create_pin	out 204	bot
DELETE	/channels/{channel_id}/pins/{message_id}deprecated_delete_pin	out 204	bot
GET	/channels/{channel_id}/polls/{message_id}/answers/{answer_id}get_answer_voters	out PollAnswerDetailsResponse	bot
POST	/channels/{channel_id}/polls/{message_id}/expirepoll_expire	out MessageResponse	bot
PUT	/channels/{channel_id}/recipients/{user_id}add_group_dm_user	in objectout PrivateChannelResponse \| PrivateGroupChannelResponse	bot
DELETE	/channels/{channel_id}/recipients/{user_id}delete_group_dm_user	out 204	bot
POST	/channels/{channel_id}/send-soundboard-soundsend_soundboard_sound	in SoundboardSoundSendRequestout 204	bot
GET	/channels/{channel_id}/thread-memberslist_thread_members	out ThreadMemberResponse[]	bot
GET	/channels/{channel_id}/thread-members/{user_id}get_thread_member	out ThreadMemberResponse	bot
PUT	/channels/{channel_id}/thread-members/{user_id}add_thread_member	out 204	bot
DELETE	/channels/{channel_id}/thread-members/{user_id}delete_thread_member	out 204	bot
PUT	/channels/{channel_id}/thread-members/@mejoin_thread	out 204	bot
DELETE	/channels/{channel_id}/thread-members/@meleave_thread	out 204	bot
POST	/channels/{channel_id}/threadscreate_thread	in CreateForumThreadRequest \| CreateTextThreadWithoutMessageRequest, application/x-www-form-urlencoded CreateForumThreadRequest \| CreateTextThreadWithoutMessageRequest, multipart/form-data CreateForumThreadRequest \| CreateTextThreadWithoutMessageRequestout CreatedThreadResponse	bot
GET	/channels/{channel_id}/threads/archived/privatelist_private_archived_threads	out ThreadsResponse	bot
GET	/channels/{channel_id}/threads/archived/publiclist_public_archived_threads	out ThreadsResponse	bot
GET	/channels/{channel_id}/threads/searchthread_search	out ThreadSearchResponse	bot
POST	/channels/{channel_id}/typingtrigger_typing_indicator	out TypingIndicatorResponse	bot
GET	/channels/{channel_id}/users/@me/threads/archived/privatelist_my_private_archived_threads	out ThreadsResponse	bot
PUT	/channels/{channel_id}/voice-statusupdate_voice_channel_status	in objectout 204	bot
GET	/channels/{channel_id}/webhookslist_channel_webhooks	out (ApplicationIncomingWebhookResponse \| ChannelFollowerWebhookResponse \| GuildIncomingWebho…	bot
POST	/channels/{channel_id}/webhookscreate_webhook	in objectout GuildIncomingWebhookResponse	bot
GET	/gatewayget_gateway	out GatewayResponse	nonebot
GET	/gateway/botget_bot_gateway	out GatewayBotResponse	bot
GET	/guilds/{guild_id}get_guild	out GuildWithCountsResponse	bot
PATCH	/guilds/{guild_id}update_guild	in GuildPatchRequestPartialout GuildResponse	bot
GET	/guilds/{guild_id}/audit-logslist_guild_audit_log_entries	out GuildAuditLogResponse	bot
GET	/guilds/{guild_id}/auto-moderation/ruleslist_auto_moderation_rules	out ((DefaultKeywordRuleResponse \| KeywordRuleResponse \| MLSpamRuleResponse \| MentionSpamRule…	bot
POST	/guilds/{guild_id}/auto-moderation/rulescreate_auto_moderation_rule	in DefaultKeywordListUpsertRequest \| KeywordUpsertRequest \| MLSpamUpsertRequest \| MentionSpa…out DefaultKeywordRuleResponse \| KeywordRuleResponse \| MLSpamRuleResponse \| MentionSpamRuleRe…	bot
GET	/guilds/{guild_id}/auto-moderation/rules/{rule_id}get_auto_moderation_rule	out DefaultKeywordRuleResponse \| KeywordRuleResponse \| MLSpamRuleResponse \| MentionSpamRuleRe…	bot
PATCH	/guilds/{guild_id}/auto-moderation/rules/{rule_id}update_auto_moderation_rule	in DefaultKeywordListUpsertRequestPartial \| KeywordUpsertRequestPartial \| MLSpamUpsertReques…out DefaultKeywordRuleResponse \| KeywordRuleResponse \| MLSpamRuleResponse \| MentionSpamRuleRe…	bot
DELETE	/guilds/{guild_id}/auto-moderation/rules/{rule_id}delete_auto_moderation_rule	out 204	bot
GET	/guilds/{guild_id}/banslist_guild_bans	out GuildBanResponse[]\|null	bot
GET	/guilds/{guild_id}/bans/{user_id}get_guild_ban	out GuildBanResponse	bot
PUT	/guilds/{guild_id}/bans/{user_id}ban_user_from_guild	in BanUserFromGuildRequestout 204	bot
DELETE	/guilds/{guild_id}/bans/{user_id}unban_user_from_guild	in UnbanUserFromGuildRequestout 204	bot
POST	/guilds/{guild_id}/bulk-banbulk_ban_users_from_guild	in BulkBanUsersRequestout BulkBanUsersResponse	bot
GET	/guilds/{guild_id}/channelslist_guild_channels	out (GuildChannelResponse \| PrivateChannelResponse \| PrivateGroupChannelResponse \| ThreadResp…	botoauth2
POST	/guilds/{guild_id}/channelscreate_guild_channel	in CreateGuildChannelRequestout GuildChannelResponse	bot
PATCH	/guilds/{guild_id}/channelsbulk_update_guild_channels	in object[]out 204	bot
GET	/guilds/{guild_id}/emojislist_guild_emojis	out EmojiResponse[]\|null	bot
POST	/guilds/{guild_id}/emojiscreate_guild_emoji	in objectout EmojiResponse	bot
GET	/guilds/{guild_id}/emojis/{emoji_id}get_guild_emoji	out EmojiResponse	bot
PATCH	/guilds/{guild_id}/emojis/{emoji_id}update_guild_emoji	in objectout EmojiResponse	bot
DELETE	/guilds/{guild_id}/emojis/{emoji_id}delete_guild_emoji	out 204	bot
PUT	/guilds/{guild_id}/incident-actionsupdate_guild_incident_actions	in GuildIncidentActionsRequestout GuildIncidentsDataResponse	bot
GET	/guilds/{guild_id}/integrationslist_guild_integrations	out (DiscordIntegrationResponse \| ExternalConnectionIntegrationResponse \| GuildSubscriptionIn…	bot
DELETE	/guilds/{guild_id}/integrations/{integration_id}delete_guild_integration	out 204	bot
GET	/guilds/{guild_id}/inviteslist_guild_invites	out ((FriendInviteResponse \| GroupDMInviteResponse \| GuildInviteResponse)\|null)[]\|null	bot
GET	/guilds/{guild_id}/memberslist_guild_members	out GuildMemberResponse[]	bot
GET	/guilds/{guild_id}/members/{user_id}get_guild_member	out GuildMemberResponse	bot
PUT	/guilds/{guild_id}/members/{user_id}add_guild_member	in BotAddGuildMemberRequestout GuildMemberResponse	bot
PATCH	/guilds/{guild_id}/members/{user_id}update_guild_member	in objectout GuildMemberResponse	bot
DELETE	/guilds/{guild_id}/members/{user_id}delete_guild_member	out 204	bot
PUT	/guilds/{guild_id}/members/{user_id}/roles/{role_id}add_guild_member_role	out 204	bot
DELETE	/guilds/{guild_id}/members/{user_id}/roles/{role_id}delete_guild_member_role	out 204	bot
PATCH	/guilds/{guild_id}/members/@meupdate_my_guild_member	in objectout PrivateGuildMemberResponse	bot
GET	/guilds/{guild_id}/members/searchsearch_guild_members	out GuildMemberResponse[]	bot
GET	/guilds/{guild_id}/messages/searchguild_search	out GuildSearchResponse	botoauth2
GET	/guilds/{guild_id}/new-member-welcomeget_guild_new_member_welcome	out GuildHomeSettingsResponse	bot
GET	/guilds/{guild_id}/onboardingget_guilds_onboarding	out UserGuildOnboardingResponse	bot
PUT	/guilds/{guild_id}/onboardingput_guilds_onboarding	in UpdateGuildOnboardingRequestout GuildOnboardingResponse	bot
GET	/guilds/{guild_id}/permissions/member/{user_id}get_guild_member_permissions	out PermissionsResponse	bot	12d ago
GET	/guilds/{guild_id}/permissions/role/{role_id}get_guild_role_permissions	out PermissionsResponse	bot	12d ago
GET	/guilds/{guild_id}/previewget_guild_preview	out GuildPreviewResponse	bot
GET	/guilds/{guild_id}/prunepreview_prune_guild	out GuildPruneResponse	bot
POST	/guilds/{guild_id}/pruneprune_guild	in PruneGuildRequestout GuildPruneResponse	bot
GET	/guilds/{guild_id}/regionslist_guild_voice_regions	out VoiceRegionResponse[]\|null	bot
GET	/guilds/{guild_id}/requestsget_guild_join_requests	out GuildJoinRequestsListResponse	bot
PATCH	/guilds/{guild_id}/requests/{request_id}action_guild_join_request	in objectout GuildJoinRequestResponse	bot
GET	/guilds/{guild_id}/roleslist_guild_roles	out GuildRoleResponse[]	bot
POST	/guilds/{guild_id}/rolescreate_guild_role	in CreateRoleRequestout GuildRoleResponse	bot
PATCH	/guilds/{guild_id}/rolesbulk_update_guild_roles	in UpdateRolePositionsRequest[]out GuildRoleResponse[]	bot
GET	/guilds/{guild_id}/roles/{role_id}get_guild_role	out GuildRoleResponse	bot
PATCH	/guilds/{guild_id}/roles/{role_id}update_guild_role	in UpdateRoleRequestPartialout GuildRoleResponse	bot
DELETE	/guilds/{guild_id}/roles/{role_id}delete_guild_role	out 204	bot
GET	/guilds/{guild_id}/roles/member-countsguild_role_member_counts	out map<integer>	bot
GET	/guilds/{guild_id}/scheduled-eventslist_guild_scheduled_events	out (ExternalScheduledEventResponse \| StageScheduledEventResponse \| VoiceScheduledEventRespon…	bot
POST	/guilds/{guild_id}/scheduled-eventscreate_guild_scheduled_event	in ExternalScheduledEventCreateRequest \| StageScheduledEventCreateRequest \| VoiceScheduledEv…out ExternalScheduledEventResponse \| StageScheduledEventResponse \| VoiceScheduledEventResponse	bot
GET	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}get_guild_scheduled_event	out ExternalScheduledEventResponse \| StageScheduledEventResponse \| VoiceScheduledEventResponse	bot
PATCH	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}update_guild_scheduled_event	in ExternalScheduledEventPatchRequestPartial \| StageScheduledEventPatchRequestPartial \| Voic…out ExternalScheduledEventResponse \| StageScheduledEventResponse \| VoiceScheduledEventResponse	bot
DELETE	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}delete_guild_scheduled_event	out 204	bot
GET	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/{guild_scheduled_event_exception_id}/userslist_guild_scheduled_event_exception_users	out ScheduledEventUserResponse[]\|null	bot
POST	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptionscreate_guild_scheduled_event_exception	in GuildScheduledEventExceptionCreateRequestout GuildScheduledEventExceptionResponse	bot
PATCH	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions/{exception_id}update_guild_scheduled_event_exception	in GuildScheduledEventExceptionPatchRequestPartialout GuildScheduledEventExceptionResponse	bot
DELETE	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions/{exception_id}delete_guild_scheduled_event_exception	out 204	bot
GET	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/userslist_guild_scheduled_event_users	out ScheduledEventUserResponse[]\|null	bot
GET	/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/users/countscount_guild_scheduled_event_users	out ScheduledEventUserCountResponse	bot
GET	/guilds/{guild_id}/soundboard-soundslist_guild_soundboard_sounds	out ListGuildSoundboardSoundsResponse	bot

Showing 150 of 250 endpoints, sorted by path.

Source: discord/discord-api-spec. "Added" is the spec update an endpoint first appeared in; blank means it was already there when tracking began. Auth lists alternatives: any one of them works. Checked Nov 9, 16:51 UTC.

API endpoints

Appearance

Theme

Accent colour

Font

Density

Corners

Motion

Sidebar

Keyboard shortcuts

Overview

Client

Experiments & rollouts

Developer API

Platform

Data & tools