Discordbot

Adds a user to a discord group direct message (dm) channel.

Adds a user (who is not already a member) to a guild using their `access token` (which must have `guilds.join` scope), optionally setting nickname, roles, mute/deaf status, or flags.

Assigns a role to a guild member, provided the bot has 'manage roles' permission in the guild and the role to be assigned is hierarchically lower than the bot's highest role.

Adds an emoji reaction from the authenticated user/bot to a specific message in a discord channel; does not return information about existing reactions.

Adds a user to a specific, unarchived thread; the user must have access to the thread's parent channel, and for private threads, the bot must already be a member.

Permanently bans a user from a discord guild, optionally deleting their recent messages (specify deletion period in seconds or days, not both).

Bans up to 200 users from a discord guild, optionally deleting their recent messages; the bot must have 'ban members' permission in the guild, and this action is irreversible.

Atomically bulk deletes messages in a discord channel for moderation or maintenance; deletion may not be instantaneous and messages are unrecoverable.

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 have registration limits; for guild-specific commands, use a different action.

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 for body content).

Creates a new invite for the specified discord channel, provided the bot has 'create instant invite' permission for that channel.

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 fetches the channel and does not send messages.

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 also be set.

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 ui updates may take up to an hour.

Creates a new discord channel (text, voice, category, etc.) within a guild, with options for permissions, topic, and type-specific settings.

Creates a new custom emoji in a specified discord guild, requiring `create expressions` permission and adherence to guild emoji limits.

Creates a new discord guild by applying channels, roles, and settings from a specified, valid, and accessible guild template code.

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) are mutually exclusive.

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) is required, and its specific fields depend on the event's `entity type`.

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 level for sticker slots.

Creates a template of an existing discord guild's structure (settings, roles, channels) but not its content (e.g., messages, members).

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.

Sends a message to a specified discord channel (text, embeds, stickers, components, attachments); requires `send messages` permission and one of `content`, `embeds`, `sticker ids`, or `attachments`.

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.

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 request body.

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).

Creates a webhook in a specified discord channel for external applications to post messages, provided the caller has 'manage webhooks' permission in that channel.

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 sent by a webhook.

Deletes all reactions (not just the bot's) from a message in a channel; requires 'manage messages' permission.

Removes all reactions for a specific emoji from a message in a discord channel; requires 'manage messages' permission and this operation is irreversible.

Permanently deletes a specific application command; this action is irreversible.

Deletes a specific auto-moderation rule from a discord guild.

Permanently deletes a discord channel by its id; this action is irreversible and the channel must exist and be deletable.

Deletes a specific user's or role's permission overwrite in a discord channel, reverting their permissions to default; this action is irreversible.

Permanently removes a user from an accessible discord group dm channel, revoking their access.

Permanently deletes a specified discord guild (server); the authenticated user must be the owner of the guild.

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.

Permanently deletes a specified custom emoji from a guild, requiring 'manage expressions' permissions; cannot delete default emojis and is irreversible.

Permanently deletes a specific, unwanted or problematic integration from a discord guild; requires 'manage server' or 'administrator' permissions.

Removes (kicks) a member from a discord guild; the user must be an existing member of the specified guild, and this action is permanent.

Removes a specified role from a member of a discord guild, provided the member currently possesses that role.

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 the bot's highest role.

Permanently deletes a specific scheduled event from a discord guild; this action is irreversible.

Permanently deletes a custom sticker from a discord guild; the specified guild and sticker must exist, and this action is irreversible.

Deletes an existing guild template by its unique code from a specified guild, returning the deleted template's details.

Permanently and irreversibly deletes a message from a specified discord channel.

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 remove others' reactions.

Permanently deletes an existing original message posted by a webhook (using its id and token), optionally within a specific thread.

Deletes the stage instance for the given `channel id`, permanently ending its live audio event.

Removes a user from a specified, unarchived thread in a discord channel.

Removes a specific user's emoji reaction from a message; requires 'manage messages' permission if deleting reactions from other users.

Permanently deletes a specified, existing discord webhook by its unique id; this action is irreversible.

Permanently deletes a discord webhook specified by its id and token; this action is irreversible.

Deletes a message previously sent by the specified webhook, optionally within a specific thread.

Forwards github event notifications to a discord channel via a webhook configured for github-formatted payloads (url ending in `/github`).

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.

Executes a discord webhook to send messages, embeds, or interactive components to a specific discord channel or thread.

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 server and that it has community features enabled.

Retrieves all currently active and visible threads within a specified discord guild, excluding archived or hidden threads.

Retrieves the full details of a discord application using its unique `application id`.

Fetches the details of a specific, existing application command, identified by its application snowflake id and command snowflake id.

Retrieves all role connection metadata records for a given discord application id; an empty list is returned if none are configured.

Fetches the role connection object for the current user for a specified discord application.

Retrieves the complete configuration details of a specific auto-moderation rule within a discord guild for inspection or verification.

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.

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 metadata, not message content or member lists.

Retrieves the websocket url to connect to discord's gateway for receiving real-time events.

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.

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 the guild id is known and accessible.

Fetches detailed information for a specific application command within a discord guild, identified by `application id`, `guild id`, and `command id`.

Fetches the permissions for a specific application command within a guild, used to inspect its current access settings.

Fetches the ban details for a specific user in a discord guild, if that user is currently banned.

Retrieves details for a specific custom emoji within a specified discord guild, requiring valid and accessible guild and emoji ids.

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).

Retrieves the configured new member welcome screen for a discord guild, detailing the welcome message, suggested member actions, and resource channels.

Fetches a public preview of a discord guild by its id, if the guild has the preview feature enabled.

Retrieves a specific scheduled event from a discord guild by its id, optionally including the count of subscribed users.

Retrieves a specific sticker from a discord guild using the guild and sticker ids; requires the sticker to exist in the guild.

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.

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.

Retrieves all webhook objects for a specified discord guild; requires 'manage webhooks' permission for the authenticated entity.

Retrieves the configured welcome screen for a specific discord guild that has the 'community' feature enabled.

Retrieves the public json widget data for a discord guild, if the widget is enabled for that guild.

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`.

Retrieves a specific message from a discord channel, identified by `channel id` and `message id`, if the channel and message exist and are accessible.

Retrieves detailed information about the current authenticated discord application.

Retrieves detailed information about the oauth2 application associated with the current authentication; cannot query other applications.

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 if `thread id` is provided.

Retrieves discord's oauth2 public keys (jwk format) for verifying access tokens; keys may rotate, so refresh caches periodically.

Gets the active stage instance for a given stage channel id.

Retrieves a specific discord sticker by its unique id.

Retrieves a member from a specified thread using their user id, optionally including the full guild member object.

Fetches public information for a discord user, requiring a valid and existing user id (snowflake).

Retrieves detailed information for an existing discord webhook, identified by its unique id, to verify settings or manage the webhook.

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.

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.

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 permissions.

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 invites' permissions on the server.

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 joining, provided the thread is joinable, not locked or full, and the user has permissions.

Enables the authenticated user to leave a specified discord guild of which they are a member but not the owner; this action is irreversible.

Removes the currently authenticated user from a specified, existing, and accessible discord thread of which they are currently a member.

Fetches all global application commands for the specified discord application id; does not fetch guild-specific commands.

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.

Fetches all active invites for a given discord channel id (read-only), requiring channel invite view permissions; response object structures may vary.

Fetches detailed information for all webhooks in a given valid discord channel, useful for review or auditing purposes.

Fetches all application command definitions (slash, user, and message types) for a specific application within a given discord guild, optionally including localizations; does not return permissions or usage statistics.

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 troubleshooting command access.

Retrieves audit log entries (e.g., message deletions, member kicks/bans, role changes) for a specified discord guild, requiring 'view audit log' permission.

Fetches a list of users banned from a specified discord guild; `before`/`after` parameters require user ids from previous results for correct pagination.

Fetches all channels (e.g., text, voice, category, threads) and their structural information for a specified discord guild id; does not include message content.

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.

Lists all integration objects for a specified discord guild.

Retrieves all currently active invite codes for a specified discord guild, typically for administration, analytics, or managing guild invitations.

Retrieves members for a discord guild; requires a valid guild id for an existing guild.

Fetches all roles in a discord guild, providing details for each role but not user assignments; `guild id` must be valid.

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.

Fetches users who have expressed interest in a specific scheduled event, requiring valid guild and event ids.

Retrieves all custom sticker objects for a discord guild; does not include standard/nitro stickers.

Retrieves all guild templates for an existing discord guild, specified by its id.

Fetches a list of available voice regions for a specified discord guild.

Retrieves historical messages from a specified, accessible discord channel, typically newest first; for real-time messages, use discord's websocket gateway api.

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.

Retrieves private archived threads from a specified channel that the current user is a member of.

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.

Lists a channel's private archived threads, sorted by most recent archival, requiring view access to them.

Lists public archived threads in an accessible discord channel, returning an empty list if none exist; does not list private or active threads.

Fetches sticker packs available to nitro subscribers on discord, excluding custom or guild-specific ones.

Retrieves members of a specified discord thread, with an option to include full guild member objects for each.

Lists all available discord voice regions with their id, name, operational status (custom, deprecated, optimal), noting that availability may vary by server.

Pins a message in a discord channel for increased visibility, if the channel's pin limit (typically 50) is not exceeded.

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.

Removes inactive members from a discord guild, requiring 'kick members' permission; use `compute prune count=true` to preview results before actual removal.

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 flow's active status.

Searches for members in a specific discord guild, allowing filtering by a query string.

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` and `deny` bitwise values to precisely control permissions.

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 from this template.

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 response.