Create application command objects
Creates a new global discord application command, accessible across guilds and in dms (if `dm permission` is true), noting global commands can take up to an hour to propagate and…
Create guild auto moderation rule
Creates a new auto moderation rule for a discord guild, requiring 'manage guild' permission; rule parameters are passed in the json request body (see request schema description f…
Create channel invite
Creates a new invite for the specified discord channel, provided the bot has 'create instant invite' permission for that channel.
Initiate user channel with recipient
Creates a new direct message (dm) channel or retrieves an existing one, using `recipient id` for a 1-on-1 dm or `access tokens` for a group dm; this action only establishes or fe…
Create new guild object
Creates a new discord guild (server) with the specified name, roles, and channels; icon must be a base64 encoded 128x128 image, and if `afk channel id` is set, `afk timeout` must…
Create guild application command
Creates a new guild-specific application command (slash, user, or message) in discord; command name must be unique per type within the guild (max 100 total commands), and client …
Create guild channel
Creates a new discord channel (text, voice, category, etc.) within a guild, with options for permissions, topic, and type-specific settings.
Create guild emoji
Creates a new custom emoji in a specified discord guild, requiring `create expressions` permission and adherence to guild emoji limits.
Post guild template by code
Creates a new discord guild by applying channels, roles, and settings from a specified, valid, and accessible guild template code.
Create role with guild id
Creates a new role in a discord guild with customizable name, permissions, color, hoist, mentionability, and icon; `icon` (custom image hash) and `unicode emoji` (standard emoji)…
Create guild scheduled event
Creates a new scheduled event in a discord guild; a separate json request body (not defined in this action's request schema model) with event details (e.g., name, type, schedule)…
Create guild sticker
Uploads a png, apng, or lottie json file (max 512kb) as a new custom sticker to the specified discord guild; requires 'manage expressions' permissions and sufficient server boost…
Create guild template
Creates a template of an existing discord guild's structure (settings, roles, channels) but not its content (e.g., messages, members).
Post interaction callback
Sends a response to a discord interaction (e.g., slash command, component); ensure response type is context-appropriate and initial reply is within 3 seconds.
Post message to channel
Sends a message to a specified discord channel (text, embeds, stickers, components, attachments); requires `send messages` permission and one of `content`, `embeds`, `sticker ids…
Create stage instance
Creates a new stage instance in a specified stage channel for live audio events; requires `manage channels`, `mute members`, and `move members` permissions in the channel.
Create new thread in channel
Creates a new thread in a text or announcement discord channel; requires a 'name' and optionally other details (e.g., 'auto archive duration', an initial 'message') in the reques…
Create thread in message channel
Creates a new thread from a specific message in a discord channel, requiring `create public threads` permission (and `send messages` if in a forum/media channel).
Create channel webhook
Creates a webhook in a specified discord channel for external applications to post messages, provided the caller has 'manage webhooks' permission in that channel.
Crosspost channel message
Crossposts a message from an announcement channel to all following channels, provided the message has not been previously crossposted and is not a system message or a message sen…
Delete reaction from message
Deletes all reactions (not just the bot's) from a message in a channel; requires 'manage messages' permission.
Delete channel message reaction by emoji
Removes all reactions for a specific emoji from a message in a discord channel; requires 'manage messages' permission and this operation is irreversible.
Delete application command
Permanently deletes a specific application command; this action is irreversible.
Delete guild auto moderation rule
Deletes a specific auto-moderation rule from a discord guild.
Delete channel by id
Permanently deletes a discord channel by its id; this action is irreversible and the channel must exist and be deletable.
Delete channel permission override
Deletes a specific user's or role's permission overwrite in a discord channel, reverting their permissions to default; this action is irreversible.
Delete channel recipient
Permanently removes a user from an accessible discord group dm channel, revoking their access.
Delete guild by id
Permanently deletes a specified discord guild (server); the authenticated user must be the owner of the guild.
Delete guild command
Permanently deletes a specific application command (e.g., slash, user, or message) for an application from a discord guild, used to remove outdated or unnecessary commands.
Delete guild emoji by id
Permanently deletes a specified custom emoji from a guild, requiring 'manage expressions' permissions; cannot delete default emojis and is irreversible.
Delete guild integration
Permanently deletes a specific, unwanted or problematic integration from a discord guild; requires 'manage server' or 'administrator' permissions.
Delete guild member by id
Removes (kicks) a member from a discord guild; the user must be an existing member of the specified guild, and this action is permanent.
Delete guild member role
Removes a specified role from a member of a discord guild, provided the member currently possesses that role.
Delete role from guild
Permanently deletes a specified role from a discord guild, revoking it from all members; requires 'manage roles' permission and the target role must be lower in hierarchy than th…
Delete guild scheduled event
Permanently deletes a specific scheduled event from a discord guild; this action is irreversible.
Delete guild sticker
Permanently deletes a custom sticker from a discord guild; the specified guild and sticker must exist, and this action is irreversible.
Delete guild template by code
Deletes an existing guild template by its unique code from a specified guild, returning the deleted template's details.
Delete channel message
Permanently and irreversibly deletes a message from a specified discord channel.
Delete user reaction on message
Removes the authenticated user's own emoji reaction, which they must have previously added, from a specific message in a discord channel; this action is irreversible and cannot r…
Delete original webhook message
Permanently deletes an existing original message posted by a webhook (using its id and token), optionally within a specific thread.
Delete stage instance by channel id
Deletes the stage instance for the given `channel id`, permanently ending its live audio event.
Delete channel thread member
Removes a user from a specified, unarchived thread in a discord channel.
Delete user reaction from message
Removes a specific user's emoji reaction from a message; requires 'manage messages' permission if deleting reactions from other users.
Delete webhook by id
Permanently deletes a specified, existing discord webhook by its unique id; this action is irreversible.
Delete webhook using id and token
Permanently deletes a discord webhook specified by its id and token; this action is irreversible.
Delete webhook message
Deletes a message previously sent by the specified webhook, optionally within a specific thread.
Github action webhooks processing
Forwards github event notifications to a discord channel via a webhook configured for github-formatted payloads (url ending in `/github`).
Post to slack webhook
Sends richly formatted messages to discord via its slack-compatible webhook endpoint; requires at least one of `text` or `attachments` and adherence to content limits.
Post webhook with embeds and components
Executes a discord webhook to send messages, embeds, or interactive components to a specific discord channel or thread.
Add follower to channel via webhook
Follows a specified announcement channel (`channel id`), relaying its messages to `webhook channel id` in the current server; requires 'manage webhooks' permission in the current…
List active threads in guild
Retrieves all currently active and visible threads within a specified discord guild, excluding archived or hidden threads.
Retrieve application details
Retrieves the full details of a discord application using its unique `application id`.
Fetch application command by id
Fetches the details of a specific, existing application command, identified by its application snowflake id and command snowflake id.
Retrieve application role metadata
Retrieves all role connection metadata records for a given discord application id; an empty list is returned if none are configured.
Get user role connection
Fetches the role connection object for the current user for a specified discord application.
Retrieve auto moderation rule
Retrieves the complete configuration details of a specific auto-moderation rule within a discord guild for inspection or verification.
Retrieve bot gateway
Retrieves the wss url, recommended shard count, and session start limits, which are prerequisite for a bot to connect to the discord gateway and receive events.
Retrieve channel details
Retrieves detailed metadata for a specific discord channel using its `channel id`, which must be a valid and accessible channel id; note that this action returns only channel met…
Get gateway details
Retrieves the websocket url to connect to discord's gateway for receiving real-time events.
Retrieve guild details
Retrieves detailed information for a specified discord guild (server) by its `guild id`, optionally including approximate member and presence counts if `with counts` is true.
Fetch guild application command by id
Fetches detailed information for a specific application command within a discord guild, identified by `application id`, `guild id`, and `command id`.
Retrieve guild command permissions
Fetches the permissions for a specific application command within a guild, used to inspect its current access settings.
Retrieve guild user ban details
Fetches the ban details for a specific user in a discord guild, if that user is currently banned.
Fetch emoji by guild and id
Retrieves details for a specific custom emoji within a specified discord guild, requiring valid and accessible guild and emoji ids.
Retrieve guild member by user id
Retrieves detailed information for a specific member of a discord guild, provided the bot belongs to the guild and has necessary permissions (e.g., guild members intent).
Retrieve guild new member welcome
Retrieves the configured new member welcome screen for a discord guild, detailing the welcome message, suggested member actions, and resource channels.
Preview guild by id
Fetches a public preview of a discord guild by its id, if the guild has the preview feature enabled.
Get guild scheduled event by id
Retrieves a specific scheduled event from a discord guild by its id, optionally including the count of subscribed users.
Get guild onboarding by id
Retrieves the onboarding settings for a specified discord guild, including prompts, options, default channels, and enabled status, to examine its new member guidance process when…
Retrieve sticker from guild
Retrieves a specific sticker from a discord guild using the guild and sticker ids; requires the sticker to exist in the guild.
Retrieve guild template with code
Retrieves the complete structure and details of a discord guild template using its unique code; the code must be valid and refer to an existing, accessible template.
Retrieve guild vanity url
Fetches the vanity url, including the invite `code` and its `uses` count, for a given discord `guild id`, which must correspond to an existing guild.
Retrieve guild webhooks
Retrieves all webhook objects for a specified discord guild; requires 'manage webhooks' permission for the authenticated entity.
Retrieve guild welcome screen
Retrieves the configured welcome screen for a specific discord guild that has the 'community' feature enabled.
Retrieve guild widget json
Retrieves the public json widget data for a discord guild, if the widget is enabled for that guild.
Retrieve guild widget information
Retrieves the widget settings for a specified discord guild, indicating if the widget is enabled and its configured channel id; requires a valid `guild id`.
Retrieve message from channel
Retrieves a specific message from a discord channel, identified by `channel id` and `message id`, if the channel and message exist and are accessible.
Get your applications
Retrieves detailed information about the current authenticated discord application.
Get oauth2 applications for current user
Retrieves detailed information about the oauth2 application associated with the current authentication; cannot query other applications.
Retrieve original webhook message
Fetches the original, unedited message posted by a specific discord webhook, requiring a message to have been previously sent by this webhook and to exist in the specified thread…
Get oauth2 keys
Retrieves discord's oauth2 public keys (jwk format) for verifying access tokens; keys may rotate, so refresh caches periodically.
Retrieve stage instance by channel id
Gets the active stage instance for a given stage channel id.
Retrieve sticker by id
Retrieves a specific discord sticker by its unique id.
Retrieve thread member by id
Retrieves a member from a specified thread using their user id, optionally including the full guild member object.
Retrieve user by id
Fetches public information for a discord user, requiring a valid and existing user id (snowflake).
Retrieve webhook by id
Retrieves detailed information for an existing discord webhook, identified by its unique id, to verify settings or manage the webhook.
Retrieve webhook information
Fetches a discord webhook's configuration details (e.g., name, avatar, channel id) using its id and token; this excludes message history or usage statistics.
Retrieve webhook message by id
Retrieves a specific message previously sent by a discord webhook using its `message id`, requiring `thread id` if the message is part of a thread.
Retrieve invite by code
Resolves a discord invite code to get its details, optionally including member counts or data for a specific guild scheduled event; visibility of some details may depend on bot p…
Delete invite via code
Revokes a discord server invite using its unique code, permanently preventing new joins via this link (does not affect existing members); requires 'manage server' or 'manage invi…
Update thread membership
Joins the authenticated user to a thread specified by `channel id`; use this when the user is not already a member, for archived threads, or for threads requiring explicit joinin…
Delete user guild
Enables the authenticated user to leave a specified discord guild of which they are a member but not the owner; this action is irreversible.
Remove current user from thread
Removes the currently authenticated user from a specified, existing, and accessible discord thread of which they are currently a member.
List commands for application
Fetches all global application commands for the specified discord application id; does not fetch guild-specific commands.
Retrieve guild auto moderation rules
Fetches all auto moderation rules for a specified discord guild to review or audit its configuration; requires `view audit log` permissions and the action does not modify rules.
List Channel Invites
Fetches all active invites for a given discord channel id (read-only), requiring channel invite view permissions; response object structures may vary.
Retrieve channel webhooks
Fetches detailed information for all webhooks in a given valid discord channel, useful for review or auditing purposes.
Get application guild command permissions
Call this action to retrieve all explicitly set guild-level permission settings for all commands of a specific application within a given guild, typically for auditing or trouble…
Fetch guild commands via application id
Fetches all application command definitions (slash, user, and message types) for a specific application within a given discord guild, optionally including localizations; does not…
Get guild audit logs by guild id
Retrieves audit log entries (e.g., message deletions, member kicks/bans, role changes) for a specified discord guild, requiring 'view audit log' permission.
List guild bans
Fetches a list of users banned from a specified discord guild; `before`/`after` parameters require user ids from previous results for correct pagination.
Retrieve guild channels
Fetches all channels (e.g., text, voice, category, threads) and their structural information for a specified discord guild id; does not include message content.
Retrieve guild emojis
Fetches all custom emoji objects for a specified discord guild if the bot has access; returns only custom guild emojis, not standard unicode or nitro emojis.
List guild integrations
Lists all integration objects for a specified discord guild.
Retrieve guild invites by id
Retrieves all currently active invite codes for a specified discord guild, typically for administration, analytics, or managing guild invitations.
Get guild members
Retrieves members for a discord guild; requires a valid guild id for an existing guild.
List guild roles
Fetches all roles in a discord guild, providing details for each role but not user assignments; `guild id` must be valid.
Retrieve guild scheduled events
Retrieves a list of scheduled events for a specified discord guild, optionally including subscribed user counts, provided the authenticated user/bot has access to the guild.
Retrieve users for scheduled event
Fetches users who have expressed interest in a specific scheduled event, requiring valid guild and event ids.
Retrieve guild stickers
Retrieves all custom sticker objects for a discord guild; does not include standard/nitro stickers.
Get guild templates by guild id
Retrieves all guild templates for an existing discord guild, specified by its id.
List guild regions
Fetches a list of available voice regions for a specified discord guild.
Get channel message reaction by emoji
Fetches a list of users who reacted to a specific message with a given emoji in a discord channel; retrieves users for one emoji at a time.
Fetch messages from channel
Retrieves historical messages from a specified, accessible discord channel, typically newest first; for real-time messages, use discord's websocket gateway api.
Get private archived threads for user
Retrieves private archived threads from a specified channel that the current user is a member of.
Retrieve pinned messages in channel
Retrieves all currently pinned messages from a discord channel using its valid, existing id; typically limited to 50 messages, and no history of past pins is returned.
Get archived private threads by channel id
Lists a channel's private archived threads, sorted by most recent archival, requiring view access to them.
Get archived public threads by channel id
Lists public archived threads in an accessible discord channel, returning an empty list if none exist; does not list private or active threads.
List sticker packs
Fetches sticker packs available to nitro subscribers on discord, excluding custom or guild-specific ones.
List thread members in channel
Retrieves members of a specified discord thread, with an option to include full guild member objects for each.
Fetch voice regions list
Lists all available discord voice regions with their id, name, operational status (custom, deprecated, optimal), noting that availability may vary by server.
Pin message in channel
Pins a message in a discord channel for increased visibility, if the channel's pin limit (typically 50) is not exceeded.
Retrieve guild prune info
Previews the number of members that would be pruned from a discord guild based on inactivity days and optional roles; this action only returns a count and does not remove members.
Prune guild members by roles
Removes inactive members from a discord guild, requiring 'kick members' permission; use `compute prune count=true` to preview results before actual removal.
Update guild onboarding configuration
Configures or updates a discord guild's new member onboarding flow, including defining prompts with options, assigning roles/channels, setting default channels, and managing the …
Search guild members by id
Searches for members in a specific discord guild, allowing filtering by a query string.
Modify channel permissions
Updates or creates a permission overwrite for a role (type `0`) or member (type `1`) specified by `overwrite id` within an existing discord channel (`channel id`), using `allow` …
Update guild template by code
Synchronizes a guild template (by `code`) with its source guild (`guild id`), updating it to match the source's current configuration; this does not affect guilds already created…
Trigger typing indicator
Shows the bot is 'typing' in a discord channel, typically before sending a message; indicator stops after 10 seconds or upon message send, so use when actively preparing a respon…
Delete guild user ban
Revokes a ban for a user from a discord guild, allowing them to rejoin if they choose.
Delete channel message pin
Unpins a message that is currently pinned in a specified discord channel; the message itself is not deleted.
Modify application by id
Updates a discord application's settings using its `application id`; `max participants` requires the `application embedded activities` flag, and `team id`, `type`, or `install pa…
Patch command for application
Updates specified properties of a discord application command (e.g., name, description); omitted properties remain unchanged, and the `options` field, if provided, overwrites all…
Update user application role connection
Updates the authorized user's role connection for a specific application, which must have a linked role connection configured.
Modify guild auto moderation rule
Updates an existing auto-moderation rule, identified by `guild id` and `rule id` in the path, with new values for rule properties (e.g., `name`, `event type`) provided in the req…
Patch channel properties by id
Partially updates an existing discord channel, using `channel id` for identification and properties in the request body for changes, ensuring these properties are applicable to t…
Update guild settings
Updates settings for a discord guild, such as its name, region, or icon; transferring ownership requires being the current owner, and managing features or certain visual elements…
Update application guild command
Updates a specific discord application command's properties (like name, description, options, or permissions) within a given guild; `application id`, `guild id`, and `command id`…
Update guild emoji roles
Updates a custom emoji's name and/or role restrictions in a discord guild; cannot create or delete emojis, and role updates for managed emojis may be restricted by their integrat…
Modify guild member details
Updates a guild member's attributes (e.g., nickname, roles, voice state); if moving via `channel id`, it must be a valid voice channel in the guild.
Modify guild role
Updates a discord guild role's attributes (name, permissions, color, etc.); requires `manage roles` permission, and the `role icons` guild feature if using `unicode emoji`; unspe…
Update guild scheduled event
Updates attributes such as name, description, schedule, status, or location for an existing discord guild event; only fields in the request body are changed.
Update guild sticker info
Modifies a guild sticker's name, description, or tags, requiring 'manage emojis and stickers' permission.
Patch guild template information
Updates a discord guild template's `name` and/or `description` given its `guild id` and template `code`; omitted fields retain current values, and an empty string for `descriptio…
Update guild welcome screen
Updates a guild's welcome screen, including its description, enabled status, and up to 5 welcome channels; when specifying channel emojis, use `emoji name` as `emoji id` must be …
Patch guild widget endpoint
Updates an existing discord guild's widget settings, such as its enabled state or clearing its invite channel.
Update channel message
Updates a message previously sent by the bot in a discord channel, by modifying its content, embeds, components, flags, or attachment metadata (new attachments cannot be uploaded…
Update application description
Modifies settings for the current authenticated discord application (e.g., description, icon, interaction urls); setting `team id` to `null` (none) transfers team ownership, whil…
Modify guild member nickname
Modifies the nickname of the currently authenticated user within a specified discord guild.
Update current user profile
Updates the current authenticated user's discord username and/or avatar.
Patch webhook original message
Updates the original editable message previously sent by a webhook, allowing partial modification of its content (max 2000 chars), embeds (max 10), attachments (kept by `id`, met…
Modify guild voice state for me
Updates the current user's voice state in a guild (e.g., mute, request to speak), and can explicitly disconnect the user from voice; this action does not support joining or switc…
Patch guild voice state
Updates a user's voice state in a discord guild, such as toggling server mute or disconnecting from a voice channel; requires `mute members` permission to change mute status or `…
Update webhook details patch
Updates properties (e.g., name, avatar, channel id) of an existing discord webhook; the webhook and any new channel (if specified) must exist, with the new channel being in the s…
Update webhook name and avatar
Updates the default name and/or avatar for an existing discord webhook, using its id and token.
Update discord message with webhook
Updates a message previously sent by the *same* webhook, allowing partial modification of content, embeds, attachments, or components; will not edit user/bot messages.