Social — entry 006 of 38
Discord
Discord's REST and Gateway APIs let bots and apps manage servers, channels, messages, and slash commands, authenticated with a bot token for server-side integrations or OAuth2 for user-facing flows like account linking. Rate limits are enforced per route and per bucket, and most guild-management scopes only work once the bot has been added to a server with matching OAuth2 permission scopes.
AuthenticationOAuthRequires an OAuth flow; expect app registration.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreeNo paid tier — free for the documented use case.
FormatsJSONResponses can be requested as JSON.
GreatAPIs Score
Score77
Authentication8/25OAuth flow required
Pricing20/20Free to use
Docs20/20Machine-readable spec file bundled
Formats9/15Single response format
Freshness20/20Verified within 6 months
Embed this badge
<a href="https://greatapis.com/api/discord/"><img src="https://greatapis.com/badge/discord.svg" alt="Scored 77 on greatapis.com"></a>Auth quickstart
- Register an app / run the OAuth flow to obtain a bearer token.
- Send it as an Authorization header
Authorization: Bearer <token>
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
applications33
GET/applications/@me
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_my_application | PrivateApplicationResponse |
429 | — | — |
4XX | — | — |
PATCH/applications/@me
Request body
application/json — ApplicationFormPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_my_application | PrivateApplicationResponse |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_application | PrivateApplicationResponse |
429 | — | — |
4XX | — | — |
PATCH/applications/{application_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
application/json — ApplicationFormPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_application | PrivateApplicationResponse |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/activity-instances/{instance_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
instance_id | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for applications_get_activity_instance | EmbeddedActivityInstance |
429 | — | — |
4XX | — | — |
POST/applications/{application_id}/attachment
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
multipart/form-data (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for upload_application_attachment | ActivitiesAttachmentResponse |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/commands
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
with_localizations | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_application_commands | — |
429 | — | — |
4XX | — | — |
POST/applications/{application_id}/commands
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
application/json — ApplicationCommandCreateRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_application_command | ApplicationCommandResponse |
201 | 201 response for create_application_command | ApplicationCommandResponse |
429 | — | — |
4XX | — | — |
PUT/applications/{application_id}/commands
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for bulk_set_application_commands | — |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/commands/{command_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
command_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_application_command | ApplicationCommandResponse |
429 | — | — |
4XX | — | — |
PATCH/applications/{application_id}/commands/{command_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
command_id | path | yes | — |
Request body
application/json — ApplicationCommandPatchRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_application_command | ApplicationCommandResponse |
429 | — | — |
4XX | — | — |
DELETE/applications/{application_id}/commands/{command_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
command_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_application_command | — |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/emojis
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_application_emojis | ListApplicationEmojisResponse |
429 | — | — |
4XX | — | — |
POST/applications/{application_id}/emojis
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_application_emoji | EmojiResponse |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/emojis/{emoji_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
emoji_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_application_emoji | EmojiResponse |
429 | — | — |
4XX | — | — |
PATCH/applications/{application_id}/emojis/{emoji_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
emoji_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_application_emoji | EmojiResponse |
429 | — | — |
4XX | — | — |
DELETE/applications/{application_id}/emojis/{emoji_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
emoji_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_application_emoji | — |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/entitlements
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
user_id | query | no | — |
sku_ids | query | no | — |
guild_id | query | no | — |
before | query | no | — |
after | query | no | — |
limit | query | no | integer |
exclude_ended | query | no | boolean |
exclude_deleted | query | no | boolean |
only_active | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_entitlements | — |
429 | — | — |
4XX | — | — |
POST/applications/{application_id}/entitlements
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
application/json — CreateEntitlementRequestData (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_entitlement | EntitlementResponse |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/entitlements/{entitlement_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
entitlement_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_entitlement | EntitlementResponse |
429 | — | — |
4XX | — | — |
DELETE/applications/{application_id}/entitlements/{entitlement_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
entitlement_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_entitlement | — |
429 | — | — |
4XX | — | — |
POST/applications/{application_id}/entitlements/{entitlement_id}/consume
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
entitlement_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for consume_entitlement | — |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/guilds/{guild_id}/commands
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
with_localizations | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_application_commands | — |
429 | — | — |
4XX | — | — |
POST/applications/{application_id}/guilds/{guild_id}/commands
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
Request body
application/json — ApplicationCommandCreateRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_guild_application_command | ApplicationCommandResponse |
201 | 201 response for create_guild_application_command | ApplicationCommandResponse |
429 | — | — |
4XX | — | — |
PUT/applications/{application_id}/guilds/{guild_id}/commands
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for bulk_set_guild_application_commands | — |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/guilds/{guild_id}/commands/permissions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_application_command_permissions | — |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/guilds/{guild_id}/commands/{command_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
command_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_application_command | ApplicationCommandResponse |
429 | — | — |
4XX | — | — |
PATCH/applications/{application_id}/guilds/{guild_id}/commands/{command_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
command_id | path | yes | — |
Request body
application/json — ApplicationCommandPatchRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_application_command | ApplicationCommandResponse |
429 | — | — |
4XX | — | — |
DELETE/applications/{application_id}/guilds/{guild_id}/commands/{command_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
command_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_application_command | — |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
command_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_application_command_permissions | CommandPermissionsResponse |
429 | — | — |
4XX | — | — |
PUT/applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
guild_id | path | yes | — |
command_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for set_guild_application_command_permissions | CommandPermissionsResponse |
429 | — | — |
4XX | — | — |
GET/applications/{application_id}/role-connections/metadata
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_application_role_connections_metadata | — |
429 | — | — |
4XX | — | — |
PUT/applications/{application_id}/role-connections/metadata
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_application_role_connections_metadata | — |
429 | — | — |
4XX | — | — |
channels48
GET/channels/{channel_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_channel | — |
429 | — | — |
4XX | — | — |
PATCH/channels/{channel_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_channel | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for delete_channel | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/followers
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for follow_channel | ChannelFollowerResponse |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/invites
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_channel_invites | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/invites
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_channel_invite | — |
204 | 204 response for create_channel_invite | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/messages
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
around | query | no | — |
before | query | no | — |
after | query | no | — |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_messages | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/messages
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json — MessageCreateRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_message | MessageResponse |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/messages/bulk-delete
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for bulk_delete_messages | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/messages/pins
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
before | query | no | string |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_pins | PinnedMessagesResponse |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/messages/pins/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for create_pin | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/messages/pins/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_pin | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/messages/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_message | MessageResponse |
429 | — | — |
4XX | — | — |
PATCH/channels/{channel_id}/messages/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Request body
application/json — MessageEditRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_message | MessageResponse |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/messages/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_message | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/messages/{message_id}/crosspost
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for crosspost_message | MessageResponse |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/messages/{message_id}/reactions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_all_message_reactions | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
emoji_name | path | yes | string |
after | query | no | — |
limit | query | no | integer |
type | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_message_reactions_by_emoji | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
emoji_name | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_all_message_reactions_by_emoji | — |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
emoji_name | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for add_my_message_reaction | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
emoji_name | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_my_message_reaction | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/messages/{message_id}/reactions/{emoji_name}/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
emoji_name | path | yes | string |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_user_message_reaction | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/messages/{message_id}/threads
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Request body
application/json — CreateTextThreadWithMessageRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_thread_from_message | ThreadResponse |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/permissions/{overwrite_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
overwrite_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for set_channel_permission_overwrite | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/permissions/{overwrite_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
overwrite_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_channel_permission_overwrite | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/pins
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for deprecated_list_pins | — |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/pins/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for deprecated_create_pin | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/pins/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for deprecated_delete_pin | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/polls/{message_id}/answers/{answer_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
answer_id | path | yes | integer |
after | query | no | — |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_answer_voters | PollAnswerDetailsResponse |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/polls/{message_id}/expire
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
message_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for poll_expire | MessageResponse |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/recipients/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
user_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for add_group_dm_user | — |
204 | 204 response for add_group_dm_user | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/recipients/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_group_dm_user | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/send-soundboard-sound
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json — SoundboardSoundSendRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for send_soundboard_sound | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/thread-members
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
with_member | query | no | boolean |
limit | query | no | integer |
after | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_thread_members | — |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/thread-members/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for join_thread | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/thread-members/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for leave_thread | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/thread-members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
user_id | path | yes | — |
with_member | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_thread_member | ThreadMemberResponse |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/thread-members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for add_thread_member | — |
429 | — | — |
4XX | — | — |
DELETE/channels/{channel_id}/thread-members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_thread_member | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/threads
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_thread | CreatedThreadResponse |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/threads/archived/private
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
before | query | no | string |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_private_archived_threads | ThreadsResponse |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/threads/archived/public
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
before | query | no | string |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_public_archived_threads | ThreadsResponse |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/threads/search
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
name | query | no | string |
slop | query | no | integer |
min_id | query | no | — |
max_id | query | no | — |
tag | query | no | — |
tag_setting | query | no | — |
archived | query | no | boolean |
sort_by | query | no | — |
sort_order | query | no | — |
limit | query | no | integer |
offset | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for thread_search | ThreadSearchResponse |
202 | 202 response for thread_search | SearchIndexNotReadyResponse |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/typing
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for trigger_typing_indicator | TypingIndicatorResponse |
204 | 204 response for trigger_typing_indicator | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/users/@me/threads/archived/private
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
before | query | no | — |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_my_private_archived_threads | ThreadsResponse |
429 | — | — |
4XX | — | — |
PUT/channels/{channel_id}/voice-status
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for update_voice_channel_status | — |
429 | — | — |
4XX | — | — |
GET/channels/{channel_id}/webhooks
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_channel_webhooks | — |
429 | — | — |
4XX | — | — |
POST/channels/{channel_id}/webhooks
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_webhook | GuildIncomingWebhookResponse |
429 | — | — |
4XX | — | — |
gateway2
GET/gateway
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_gateway | GatewayResponse |
429 | — | — |
4XX | — | — |
GET/gateway/bot
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_bot_gateway | GatewayBotResponse |
429 | — | — |
4XX | — | — |
guilds91
GET/guilds/templates/{code}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_template | GuildTemplateResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
with_counts | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild | GuildWithCountsResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — GuildPatchRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild | GuildResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/audit-logs
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | query | no | — |
target_id | query | no | — |
action_type | query | no | — |
before | query | no | — |
after | query | no | — |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_audit_log_entries | GuildAuditLogResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/auto-moderation/rules
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_auto_moderation_rules | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/auto-moderation/rules
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_auto_moderation_rule | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/auto-moderation/rules/{rule_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
rule_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_auto_moderation_rule | — |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/auto-moderation/rules/{rule_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
rule_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_auto_moderation_rule | — |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/auto-moderation/rules/{rule_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
rule_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_auto_moderation_rule | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/bans
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
limit | query | no | integer |
before | query | no | — |
after | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_bans | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/bans/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_ban | GuildBanResponse |
429 | — | — |
4XX | — | — |
PUT/guilds/{guild_id}/bans/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Request body
application/json — BanUserFromGuildRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for ban_user_from_guild | — |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/bans/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Request body
application/json — UnbanUserFromGuildRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for unban_user_from_guild | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/bulk-ban
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — BulkBanUsersRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for bulk_ban_users_from_guild | BulkBanUsersResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/channels
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_channels | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/channels
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — CreateGuildChannelRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_guild_channel | GuildChannelResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/channels
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for bulk_update_guild_channels | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/emojis
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_emojis | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/emojis
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_guild_emoji | EmojiResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/emojis/{emoji_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
emoji_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_emoji | EmojiResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/emojis/{emoji_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
emoji_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_emoji | EmojiResponse |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/emojis/{emoji_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
emoji_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_emoji | — |
429 | — | — |
4XX | — | — |
PUT/guilds/{guild_id}/incident-actions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — GuildIncidentActionsRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_incident_actions | GuildIncidentsDataResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/integrations
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_integrations | — |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/integrations/{integration_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
integration_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_integration | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/invites
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_invites | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/members
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
limit | query | no | integer |
after | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_members | — |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/members/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_my_guild_member | PrivateGuildMemberResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/members/search
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
limit | query | no | integer |
query | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for search_guild_members | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_member | GuildMemberResponse |
429 | — | — |
4XX | — | — |
PUT/guilds/{guild_id}/members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Request body
application/json — BotAddGuildMemberRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for add_guild_member | GuildMemberResponse |
204 | 204 response for add_guild_member | — |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_member | GuildMemberResponse |
204 | 204 response for update_guild_member | — |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_member | — |
429 | — | — |
4XX | — | — |
PUT/guilds/{guild_id}/members/{user_id}/roles/{role_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
role_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for add_guild_member_role | — |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/members/{user_id}/roles/{role_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
role_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_member_role | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/messages/search
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
sort_by | query | no | — |
sort_order | query | no | — |
content | query | no | string |
slop | query | no | integer |
author_id | query | no | array |
author_type | query | no | array |
mentions | query | no | array |
mentions_role_id | query | no | array |
replied_to_user_id | query | no | array |
replied_to_message_id | query | no | array |
mention_everyone | query | no | boolean |
min_id | query | no | — |
max_id | query | no | — |
limit | query | no | integer |
offset | query | no | integer |
has | query | no | array |
link_hostname | query | no | array |
embed_provider | query | no | array |
embed_type | query | no | array |
attachment_extension | query | no | array |
attachment_filename | query | no | array |
pinned | query | no | boolean |
include_nsfw | query | no | boolean |
channel_id | query | no | array |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for guild_search | GuildSearchResponse |
202 | 202 response for guild_search | SearchIndexNotReadyResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/new-member-welcome
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_new_member_welcome | GuildHomeSettingsResponse |
204 | 204 response for get_guild_new_member_welcome | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/onboarding
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guilds_onboarding | UserGuildOnboardingResponse |
429 | — | — |
4XX | — | — |
PUT/guilds/{guild_id}/onboarding
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — UpdateGuildOnboardingRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for put_guilds_onboarding | GuildOnboardingResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/preview
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_preview | GuildPreviewResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/prune
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
days | query | no | integer |
include_roles | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for preview_prune_guild | GuildPruneResponse |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/prune
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — PruneGuildRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for prune_guild | GuildPruneResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/regions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_voice_regions | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/requests
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
status | query | no | string |
limit | query | no | integer |
before | query | no | — |
after | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_join_requests | GuildJoinRequestsListResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/requests/{request_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
request_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for action_guild_join_request | GuildJoinRequestResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/roles
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_roles | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/roles
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — CreateRoleRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_guild_role | GuildRoleResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/roles
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for bulk_update_guild_roles | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/roles/member-counts
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for guild_role_member_counts | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/roles/{role_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
role_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_role | GuildRoleResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/roles/{role_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
role_id | path | yes | — |
Request body
application/json — UpdateRoleRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_role | GuildRoleResponse |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/roles/{role_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
role_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_role | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/scheduled-events
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
with_user_count | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_scheduled_events | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/scheduled-events
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_guild_scheduled_event | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
with_user_count | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_scheduled_event | — |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_scheduled_event | — |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_scheduled_event | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
Request body
application/json — GuildScheduledEventExceptionCreateRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_guild_scheduled_event_exception | GuildScheduledEventExceptionResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions/{exception_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
exception_id | path | yes | — |
Request body
application/json — GuildScheduledEventExceptionPatchRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_scheduled_event_exception | GuildScheduledEventExceptionResponse |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/exceptions/{exception_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
exception_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_scheduled_event_exception | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/users
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
with_member | query | no | boolean |
limit | query | no | integer |
before | query | no | — |
after | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_scheduled_event_users | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/users/counts
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
guild_scheduled_event_exception_ids | query | no | array |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for count_guild_scheduled_event_users | ScheduledEventUserCountResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/scheduled-events/{guild_scheduled_event_id}/{guild_scheduled_event_exception_id}/users
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
guild_scheduled_event_id | path | yes | — |
guild_scheduled_event_exception_id | path | yes | — |
with_member | query | no | boolean |
limit | query | no | integer |
before | query | no | — |
after | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_scheduled_event_exception_users | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/soundboard-sounds
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_soundboard_sounds | ListGuildSoundboardSoundsResponse |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/soundboard-sounds
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — SoundboardCreateRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_guild_soundboard_sound | SoundboardSoundResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/soundboard-sounds/{sound_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
sound_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_soundboard_sound | SoundboardSoundResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/soundboard-sounds/{sound_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
sound_id | path | yes | — |
Request body
application/json — SoundboardPatchRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_soundboard_sound | SoundboardSoundResponse |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/soundboard-sounds/{sound_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
sound_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_soundboard_sound | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/stickers
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_stickers | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/stickers
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
multipart/form-data (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_guild_sticker | GuildStickerResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/stickers/{sticker_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
sticker_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_sticker | GuildStickerResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/stickers/{sticker_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
sticker_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_sticker | GuildStickerResponse |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/stickers/{sticker_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
sticker_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_guild_sticker | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/templates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_guild_templates | — |
429 | — | — |
4XX | — | — |
POST/guilds/{guild_id}/templates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_guild_template | GuildTemplateResponse |
429 | — | — |
4XX | — | — |
PUT/guilds/{guild_id}/templates/{code}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
code | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for sync_guild_template | GuildTemplateResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/templates/{code}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
code | path | yes | string |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_template | GuildTemplateResponse |
429 | — | — |
4XX | — | — |
DELETE/guilds/{guild_id}/templates/{code}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
code | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for delete_guild_template | GuildTemplateResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/threads/active
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_active_guild_threads | ThreadsResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/vanity-url
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_vanity_url | VanityURLResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/voice-states/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_self_voice_state | VoiceStateResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/voice-states/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — UpdateSelfVoiceStateRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for update_self_voice_state | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/voice-states/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_voice_state | VoiceStateResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/voice-states/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
user_id | path | yes | — |
Request body
application/json — UpdateVoiceStateRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for update_voice_state | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/webhooks
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_webhooks | — |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/welcome-screen
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_welcome_screen | GuildWelcomeScreenResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/welcome-screen
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json — WelcomeScreenPatchRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_welcome_screen | GuildWelcomeScreenResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/widget
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_widget_settings | WidgetSettingsResponse |
429 | — | — |
4XX | — | — |
PATCH/guilds/{guild_id}/widget
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_guild_widget_settings | WidgetSettingsResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/widget.json
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_widget | WidgetResponse |
429 | — | — |
4XX | — | — |
GET/guilds/{guild_id}/widget.png
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
style | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_guild_widget_png | — |
429 | — | — |
4XX | — | — |
interactions1
POST/interactions/{interaction_id}/{interaction_token}/callback
Parameters
| Name | In | Required | Type |
|---|---|---|---|
interaction_id | path | yes | — |
interaction_token | path | yes | string |
with_response | query | no | boolean |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_interaction_response | InteractionCallbackResponse |
204 | 204 response for create_interaction_response | — |
429 | — | — |
4XX | — | — |
invites5
GET/invites/{code}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | path | yes | string |
with_counts | query | no | boolean |
guild_scheduled_event_id | query | no | — |
target_channel_id | query | no | — |
target_message_id | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for invite_resolve | — |
429 | — | — |
4XX | — | — |
DELETE/invites/{code}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for invite_revoke | — |
429 | — | — |
4XX | — | — |
GET/invites/{code}/target-users
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_invite_target_users | — |
429 | — | — |
4XX | — | — |
PUT/invites/{code}/target-users
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | path | yes | string |
Request body
multipart/form-data (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for update_invite_target_users | — |
429 | — | — |
4XX | — | — |
GET/invites/{code}/target-users/job-status
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_invite_target_users_job_status | TargetUsersJobStatusResponse |
429 | — | — |
4XX | — | — |
lobbies15
POST/lobbies
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_lobby | LobbyResponse |
429 | — | — |
4XX | — | — |
PUT/lobbies
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_or_join_lobby | LobbyResponse |
429 | — | — |
4XX | — | — |
GET/lobbies/{lobby_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_lobby | LobbyResponse |
429 | — | — |
4XX | — | — |
PATCH/lobbies/{lobby_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for edit_lobby | LobbyResponse |
429 | — | — |
4XX | — | — |
DELETE/lobbies/{lobby_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_lobby | — |
429 | — | — |
4XX | — | — |
PATCH/lobbies/{lobby_id}/channel-linking
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for edit_lobby_channel_link | LobbyResponse |
429 | — | — |
4XX | — | — |
DELETE/lobbies/{lobby_id}/members/@me
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for leave_lobby | — |
429 | — | — |
4XX | — | — |
POST/lobbies/{lobby_id}/members/@me/invites
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_linked_lobby_guild_invite_for_self | LobbyGuildInviteResponse |
429 | — | — |
4XX | — | — |
POST/lobbies/{lobby_id}/members/bulk
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for bulk_update_lobby_members | — |
429 | — | — |
4XX | — | — |
PUT/lobbies/{lobby_id}/members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
user_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for add_lobby_member | LobbyMemberResponse |
429 | — | — |
4XX | — | — |
DELETE/lobbies/{lobby_id}/members/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_lobby_member | — |
429 | — | — |
4XX | — | — |
POST/lobbies/{lobby_id}/members/{user_id}/invites
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_linked_lobby_guild_invite_for_user | LobbyGuildInviteResponse |
429 | — | — |
4XX | — | — |
GET/lobbies/{lobby_id}/messages
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_lobby_messages | — |
429 | — | — |
4XX | — | — |
POST/lobbies/{lobby_id}/messages
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
Request body
application/json — SDKMessageRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
201 | 201 response for create_lobby_message | LobbyMessageResponse |
429 | — | — |
4XX | — | — |
PUT/lobbies/{lobby_id}/messages/{message_id}/moderation-metadata
Parameters
| Name | In | Required | Type |
|---|---|---|---|
lobby_id | path | yes | — |
message_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for update_lobby_message_external_moderation_metadata | — |
429 | — | — |
4XX | — | — |
oauth24
GET/oauth2/@me
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_my_oauth2_authorization | OAuth2GetAuthorizationResponse |
429 | — | — |
4XX | — | — |
GET/oauth2/applications/@me
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_my_oauth2_application | PrivateApplicationResponse |
429 | — | — |
4XX | — | — |
GET/oauth2/keys
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_public_keys | OAuth2GetKeys |
429 | — | — |
4XX | — | — |
GET/oauth2/userinfo
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_openid_connect_userinfo | OAuth2GetOpenIDConnectUserInfoResponse |
429 | — | — |
4XX | — | — |
partner-sdk5
PUT/partner-sdk/dms/{user_id_1}/{user_id_2}/messages/{message_id}/moderation-metadata
Parameters
| Name | In | Required | Type |
|---|---|---|---|
user_id_1 | path | yes | — |
user_id_2 | path | yes | — |
message_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for update_user_message_external_moderation_metadata | — |
429 | — | — |
4XX | — | — |
POST/partner-sdk/provisional-accounts/unmerge
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for partner_sdk_unmerge_provisional_account | — |
429 | — | — |
4XX | — | — |
POST/partner-sdk/provisional-accounts/unmerge/bot
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for bot_partner_sdk_unmerge_provisional_account | — |
429 | — | — |
4XX | — | — |
POST/partner-sdk/token
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for partner_sdk_token | ProvisionalTokenResponse |
429 | — | — |
4XX | — | — |
POST/partner-sdk/token/bot
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for bot_partner_sdk_token | ProvisionalTokenResponse |
429 | — | — |
4XX | — | — |
skus2
GET/skus/{sku_id}/subscriptions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sku_id | path | yes | — |
before | query | no | — |
after | query | no | — |
limit | query | no | integer |
user_id | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_sku_subscriptions | — |
429 | — | — |
4XX | — | — |
GET/skus/{sku_id}/subscriptions/{subscription_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sku_id | path | yes | — |
subscription_id | path | yes | — |
user_id | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_sku_subscription | SubscriptionResponse |
429 | — | — |
4XX | — | — |
soundboard-default-sounds1
GET/soundboard-default-sounds
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_soundboard_default_sounds | — |
429 | — | — |
4XX | — | — |
stage-instances4
POST/stage-instances
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_stage_instance | StageInstanceResponse |
429 | — | — |
4XX | — | — |
GET/stage-instances/{channel_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_stage_instance | StageInstanceResponse |
429 | — | — |
4XX | — | — |
PATCH/stage-instances/{channel_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_stage_instance | StageInstanceResponse |
429 | — | — |
4XX | — | — |
DELETE/stage-instances/{channel_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
channel_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_stage_instance | — |
429 | — | — |
4XX | — | — |
sticker-packs2
GET/sticker-packs
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_sticker_packs | StickerPackCollectionResponse |
429 | — | — |
4XX | — | — |
GET/sticker-packs/{pack_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
pack_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_sticker_pack | StickerPackResponse |
429 | — | — |
4XX | — | — |
stickers1
GET/stickers/{sticker_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sticker_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_sticker | — |
429 | — | — |
4XX | — | — |
users12
GET/users/@me
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_my_user | UserPIIResponse |
429 | — | — |
4XX | — | — |
PATCH/users/@me
Request body
application/json — BotAccountPatchRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_my_user | UserPIIResponse |
429 | — | — |
4XX | — | — |
GET/users/@me/applications/{application_id}/entitlements
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
sku_ids | query | no | — |
exclude_consumed | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_current_user_application_entitlements | — |
429 | — | — |
4XX | — | — |
GET/users/@me/applications/{application_id}/role-connection
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_application_user_role_connection | ApplicationUserRoleConnectionResponse |
429 | — | — |
4XX | — | — |
PUT/users/@me/applications/{application_id}/role-connection
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Request body
application/json — UpdateApplicationUserRoleConnectionRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_application_user_role_connection | ApplicationUserRoleConnectionResponse |
429 | — | — |
4XX | — | — |
DELETE/users/@me/applications/{application_id}/role-connection
Parameters
| Name | In | Required | Type |
|---|---|---|---|
application_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_application_user_role_connection | — |
429 | — | — |
4XX | — | — |
POST/users/@me/channels
Request body
application/json — CreatePrivateChannelRequest (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for create_dm | — |
429 | — | — |
4XX | — | — |
GET/users/@me/connections
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_my_connections | — |
429 | — | — |
4XX | — | — |
GET/users/@me/guilds
Parameters
| Name | In | Required | Type |
|---|---|---|---|
before | query | no | — |
after | query | no | — |
limit | query | no | integer |
with_counts | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_my_guilds | — |
429 | — | — |
4XX | — | — |
DELETE/users/@me/guilds/{guild_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for leave_guild | — |
429 | — | — |
4XX | — | — |
GET/users/@me/guilds/{guild_id}/member
Parameters
| Name | In | Required | Type |
|---|---|---|---|
guild_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_my_guild_member | PrivateGuildMemberResponse |
429 | — | — |
4XX | — | — |
GET/users/{user_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
user_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_user | UserResponse |
429 | — | — |
4XX | — | — |
voice1
GET/voice/regions
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for list_voice_regions | — |
429 | — | — |
4XX | — | — |
webhooks15
GET/webhooks/{webhook_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_webhook | — |
429 | — | — |
4XX | — | — |
PATCH/webhooks/{webhook_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_webhook | — |
429 | — | — |
4XX | — | — |
DELETE/webhooks/{webhook_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_webhook | — |
429 | — | — |
4XX | — | — |
GET/webhooks/{webhook_id}/{webhook_token}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_webhook_by_token | — |
429 | — | — |
4XX | — | — |
POST/webhooks/{webhook_id}/{webhook_token}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
wait | query | no | boolean |
thread_id | query | no | — |
with_components | query | no | boolean |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for execute_webhook | MessageResponse |
204 | 204 response for execute_webhook | — |
429 | — | — |
4XX | — | — |
PATCH/webhooks/{webhook_id}/{webhook_token}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
Request body
application/json (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_webhook_by_token | — |
429 | — | — |
4XX | — | — |
DELETE/webhooks/{webhook_id}/{webhook_token}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_webhook_by_token | — |
429 | — | — |
4XX | — | — |
POST/webhooks/{webhook_id}/{webhook_token}/github
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
wait | query | no | boolean |
thread_id | query | no | — |
Request body
application/json — GithubWebhook (required)
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for execute_github_compatible_webhook | — |
429 | — | — |
4XX | — | — |
GET/webhooks/{webhook_id}/{webhook_token}/messages/@original
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
thread_id | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_original_webhook_message | MessageResponse |
429 | — | — |
4XX | — | — |
PATCH/webhooks/{webhook_id}/{webhook_token}/messages/@original
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
thread_id | query | no | — |
with_components | query | no | boolean |
Request body
application/json — IncomingWebhookUpdateRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_original_webhook_message | MessageResponse |
429 | — | — |
4XX | — | — |
DELETE/webhooks/{webhook_id}/{webhook_token}/messages/@original
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
thread_id | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_original_webhook_message | — |
429 | — | — |
4XX | — | — |
GET/webhooks/{webhook_id}/{webhook_token}/messages/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
message_id | path | yes | — |
thread_id | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for get_webhook_message | MessageResponse |
429 | — | — |
4XX | — | — |
PATCH/webhooks/{webhook_id}/{webhook_token}/messages/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
message_id | path | yes | — |
thread_id | query | no | — |
with_components | query | no | boolean |
Request body
application/json — IncomingWebhookUpdateRequestPartial (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for update_webhook_message | MessageResponse |
429 | — | — |
4XX | — | — |
DELETE/webhooks/{webhook_id}/{webhook_token}/messages/{message_id}
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
message_id | path | yes | — |
thread_id | query | no | — |
Responses
| Status | Description | Schema |
|---|---|---|
204 | 204 response for delete_webhook_message | — |
429 | — | — |
4XX | — | — |
POST/webhooks/{webhook_id}/{webhook_token}/slack
Parameters
| Name | In | Required | Type |
|---|---|---|---|
webhook_id | path | yes | — |
webhook_token | path | yes | string |
wait | query | no | boolean |
thread_id | query | no | — |
Request body
application/json — SlackWebhook (required)
Responses
| Status | Description | Schema |
|---|---|---|
200 | 200 response for execute_slack_compatible_webhook | — |
429 | — | — |
4XX | — | — |
Try it
Developer reference
Base URL
https://discord.com/api/v10Rate limit
Bots can make up to 50 requests per second globally; individual routes share per-bucket limits identified by the X-RateLimit-Bucket header, with remaining/reset counts in X-RateLimit-Remaining and X-RateLimit-Reset. Exceeding a limit returns 429 with a retry_after field (seconds to wait); 10,000 invalid (401/403/429) requests in 10 minutes triggers a temporary IP ban.
Key endpoints
- GET/users/@me
- GET/guilds/{guild_id}
- GET/channels/{channel_id}/messages
- POST/channels/{channel_id}/messages
- GET/gateway/bot
Changelog
Spec version10
Tracked paths150
- content changed