Skip to main content
Discord Bot logo
  • Category: team chat
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 169
  • Triggers: 0
  • Slug: DISCORDBOT
  • Version: 20261101_00

Tools

Slug: DISCORDBOT_ADD_GROUP_DM_USERDEPRECATED: This tool is not supported. Discord requires a user token for group DMs, which a bot connection does not have. Adds a user to a Discord group DM channel. Requires a user OAuth2 access token with the gdm.join scope. Bot tokens cannot be used for this endpoint.

Input Parameters

string
Nickname for the user in the group DM.
string
required
ID of the user to add to the group DM channel.
string
required
ID of the group DM channel to add the user to.
string
Access token of the user being added; must have the gdm.join OAuth2 scope.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_ADD_GUILD_MEMBERAdds a user to a Discord guild using their OAuth2 access token (which must have guilds.join scope). Returns the guild member object on 201 Created, or indicates the user is already a member on 204.

Input Parameters

boolean
Whether the user should be server deafened in voice channels.
boolean
Whether the user should be server muted in voice channels.
string
Nickname to set for the user in this guild. Maximum 32 characters.
array
List of role IDs to assign to the user upon joining.
string
required
The unique identifier (snowflake ID) of the user to add.
string
required
The unique identifier (snowflake ID) of the guild to add the user to.
string
required
OAuth2 access token for the user, with guilds.join scope, to authorize adding them to the guild.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_ADD_GUILD_MEMBER_ROLEAssigns a role to a guild member, requiring MANAGE_ROLES permission and a role lower than the bot’s highest role. A 204 response is converted to a confirmation message.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord role to be assigned to the member.
string
required
The unique identifier (snowflake ID) of the Discord user to whom the role will be added.
string
required
The unique identifier (snowflake ID) of the Discord guild where the member and role exist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_ADD_MY_MESSAGE_REACTIONAdds an emoji reaction from the bot to a message. Requires READ_MESSAGE_HISTORY, and ADD_REACTIONS if no one else has reacted with this emoji yet.

Input Parameters

string
required
Emoji to react with. For Unicode emojis use the character directly (e.g., ’👍’). For custom emojis use ‘name:id’ format (e.g., ‘myemoji:123456789012345678’).
string
required
ID of the channel containing the message.
string
required
ID of the message to react to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_ADD_THREAD_MEMBERAdds a user to a specific, unarchived thread. The user must have access to the parent channel.

Input Parameters

string
required
The ID of the user to add to the thread.
string
required
The ID of the thread to add the user to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_BAN_USER_FROM_GUILDPermanently bans a user from a Discord guild, optionally deleting their recent messages.

Input Parameters

string
required
The ID of the user to ban.
string
required
The ID of the guild to ban the user from.
integer
Number of seconds (0-604800) of the user’s past messages to delete. Defaults to 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_BULK_BAN_USERS_FROM_GUILDBans up to 200 users from a Discord guild, optionally deleting their recent messages. Requires BAN_MEMBERS permission.

Input Parameters

string
required
The ID of the guild to ban users from.
array
required
Array of user IDs to ban (maximum 200).
integer
Number of seconds (0-604800) of messages to delete for banned users. Defaults to 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_BULK_DELETE_MESSAGESBulk deletes messages in a Discord channel. Requires MANAGE_MESSAGES permission. Messages must be less than 14 days old. Between 2 and 100 messages can be deleted at once.

Input Parameters

array
required
List of message IDs to delete (2-100). All messages must be less than 14 days old.
string
required
ID of the channel from which to bulk delete messages.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_APPLICATION_COMMANDDEPRECATED: This tool is no longer available. Use the guild application command tools, which register commands in the connected server. Creates a new global Discord application command. Global commands can take up to an hour to propagate. Command names must be unique per type within the application scope.

Input Parameters

string
required
1-32 character command name. For CHAT_INPUT commands, must be lowercase.
integer
Command type: 1 (CHAT_INPUT, default), 2 (USER), 3 (MESSAGE).
array
Array of command option objects (max 25). Each must have name, description, and type fields.
string
1-100 character description for CHAT_INPUT commands. Empty string or omit for USER/MESSAGE commands.
boolean
Whether the command is available in DMs (global commands only). Defaults to true.
string
required
The unique identifier (snowflake ID) of the Discord application.
object
Localization dictionary mapping locale codes to localized names (1-32 chars each).
object
Localization dictionary mapping locale codes to localized descriptions (1-100 chars each).
string
Bitwise permission flags string a member needs. ‘0’ disables for non-admins. Null allows everyone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_AUTO_MODERATION_RULECreates a new auto moderation rule for a Discord guild. Requires MANAGE_GUILD permission. Use this to set up filters for profanity, spam, excessive mentions, or custom keywords.

Input Parameters

string
required
The name of the rule (1-100 characters).
array
required
The actions to execute when the rule is triggered (max 5).
boolean
Whether the rule is enabled. Defaults to false.
string
required
The unique identifier (snowflake ID) of the Discord guild where the rule will be created.
integer
required
The event type: 1=MESSAGE_SEND, 2=MEMBER_UPDATE.
array
Role IDs not affected by the rule (max 20).
integer
required
The trigger type: 1=KEYWORD (max 6/guild), 3=SPAM (max 1/guild), 4=KEYWORD_PRESET (max 1/guild), 5=MENTION_SPAM (max 1/guild), 6=MEMBER_PROFILE (max 1/guild).
array
Channel IDs not affected by the rule (max 50).
object
Additional metadata associated with the rule’s trigger type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_CHANNEL_INVITECreates a new invite link for a Discord channel. Requires CREATE_INSTANT_INVITE permission.

Input Parameters

boolean
If true, do not reuse a similar invite. Useful for creating many unique one-time invites.
integer
Duration of invite in seconds before expiry, or 0 for never. Must be 0-604800. Defaults to 86400 (24 hours).
integer
Maximum number of times this invite can be used, or 0 for unlimited. Defaults to 0.
boolean
Whether this invite only grants temporary membership. Defaults to false.
string
required
The ID of the channel to create an invite for.
integer
The type of target for this voice channel invite. 1 for Stream, 2 for Embedded Application.
string
The ID of the user whose stream to display. Required if target_type is 1.
string
The ID of the embedded application to open. Required if target_type is 2.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_DMCreates or retrieves a one-on-one DM channel with a member of the connected server without sending a message. This action requires a custom Discord application; DMs are unavailable on the Composio-managed bot.

Input Parameters

object
Custom nicknames for users in a group DM. Keys are User IDs, values are nicknames. Only used with access_tokens.
string
The User ID (snowflake) for a 1-on-1 DM. Use this OR access_tokens, not both.
array
OAuth2 access tokens for users in a group DM (1 to 9 others). Use this OR recipient_id, not both.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILDDEPRECATED: This tool is no longer available. A Discord Bot connection works within the server it was installed in. Use DISCORDBOT_GET_CONNECTED_GUILD to read that server. Creates a new Discord guild (server). The bot must be in fewer than 10 guilds to use this endpoint. Icon must be a base64 encoded 128x128 image, and if afk_channel_id is set, afk_timeout must also be set.

Input Parameters

string
Base64 encoded 128x128 image (JPEG, PNG, or GIF) for the guild icon.
string
required
The name of the guild (2-100 characters).
array
Array of role objects for the new guild. The first role sets @everyone permissions.
string
Voice region ID (deprecated; handled automatically by Discord).
array
Array of channel objects for the new guild.
integer
AFK timeout in seconds (60, 300, 900, 1800, 3600).
string
The description for the guild.
string
The ID of the channel to which AFK users are moved. Must be a voice channel.
string
The preferred locale for a Community guild. Defaults to en-US.
string
The ID of the channel where guild system messages are posted.
integer
Verification level (0: None, 1: Low, 2: Medium, 3: High, 4: Highest).
integer
Bitwise value of system channel flags that control which system messages are sent.
integer
Explicit content filter level (0: Disabled, 1: Members without roles, 2: All members).
integer
Default message notification level (0: All Messages, 1: Only @mentions).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_APPLICATION_COMMANDCreates a guild-specific application command in the connected server. Command names must be unique per type within the guild (max 100 total commands).

Input Parameters

string
required
1-32 character command name. For CHAT_INPUT commands, must be lowercase.
integer
Command type: 1 (CHAT_INPUT, default), 2 (USER), 3 (MESSAGE).
array
Array of command option objects (max 25).
string
required
The unique identifier (snowflake ID) of the guild.
string
1-100 character description for CHAT_INPUT commands. Empty string or omit for USER/MESSAGE.
boolean
Whether the command is available in DMs. Only for globally-scoped commands.
string
required
The unique identifier (snowflake ID) of the Discord application.
object
Localization dictionary mapping locale codes to localized names.
object
Localization dictionary mapping locale codes to localized descriptions.
string
Bitwise permission flags string. ‘0’ disables for non-admins.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_CHANNELCreates a new Discord channel (text, voice, category, etc.) within a guild. Requires MANAGE_CHANNELS permission.

Input Parameters

string
required
Channel name (1-100 characters).
boolean
Whether the channel is age-restricted.
integer
Type of channel (0: GUILD_TEXT, 2: GUILD_VOICE, 4: GUILD_CATEGORY, 5: GUILD_ANNOUNCEMENT, 13: GUILD_STAGE_VOICE, 15: GUILD_FORUM).
string
Channel topic (0-1024 characters for text; 0-4096 for forum/media channels).
integer
Bitrate (in bits) for voice channels (8000-96000; up to 128000 for VIP servers).
string
required
ID of the guild (server) to create the channel in.
integer
Sorting position of the channel.
string
ID of the parent category for this channel.
string
Voice region ID for voice channels (auto if not set).
integer
Maximum users in a voice channel (0 for no limit, 1-99).
array
List of tag objects for forum/media channels (max 20). Each needs a name field.
integer
Default sort order for forum posts: 0 for Latest Activity, 1 for Creation Date.
integer
Camera video quality for voice channels: 1 for auto, 2 for 720p.
integer
Slowmode: seconds a user must wait before sending another message (0-21600).
integer
Default forum layout: 0 for Not Set, 1 for List View, 2 for Gallery View.
array
Permission overwrite objects for the channel.
object
Default reaction emoji for forum/media channels. Must contain emoji_id or emoji_name.
integer
Default duration (minutes) for new threads to auto-archive (60, 1440, 4320, 10080).
integer
Initial rate_limit_per_user for new threads in text channels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_EMOJICreates a new custom emoji in a specified Discord guild, requiring CREATE_EXPRESSIONS permission and adherence to guild emoji limits.

Input Parameters

string
required
The name for the new emoji. Must be between 2 and 32 characters long and can only contain alphanumeric characters and underscores.
string
required
The base64 encoded image data for the emoji. Must be a 128x128px GIF or PNG. The data must be URI encoded (e.g., ‘data:image/png;base64,BASE64_ENCODED_IMAGE_DATA’). Image size should be less than 256KB.
array
An array of role IDs to which this emoji will be restricted. If omitted or empty, the emoji is available to @everyone.
string
required
The ID of the Discord guild (server) where the emoji will be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_FROM_TEMPLATEDEPRECATED: This tool is no longer available. A Discord Bot connection works within the server it was installed in. Use DISCORDBOT_GET_CONNECTED_GUILD to read that server. Creates a new Discord guild by applying channels, roles, and settings from a specified guild template code.

Input Parameters

string
Data URI scheme (e.g., ‘data:image/png;base64,…’) for the guild’s 128x128 icon.
string
required
Name for the new guild (2-100 characters).
string
required
The unique code of the guild template to use.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_ROLECreates a new role in a Discord guild with customizable name, permissions, color, hoist, mentionability, and icon. Requires MANAGE_ROLES permission. The icon and unicode_emoji fields are mutually exclusive.

Input Parameters

string
Hash of a custom image for the role’s icon. Mutually exclusive with unicode_emoji.
string
Name for the new role. If omitted, Discord defaults to ‘new role’.
integer
RGB color value for the role as an integer (e.g., red is 16711680). Defaults to 0 (no color).
boolean
If true, displays the role separately in the member list. Defaults to false.
string
required
The unique identifier (snowflake ID) of the Discord guild where the role will be created.
boolean
If true, this role can be mentioned by others. Defaults to false.
string
Bitwise integer for role permissions combined from Discord permission flags.
string
Standard Unicode emoji for the role’s icon. Mutually exclusive with icon.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_SCHEDULED_EVENTCreates a new scheduled event in a Discord guild. Events can be hosted in stage channels, voice channels, or external locations. STAGE_INSTANCE/VOICE require channel_id, while EXTERNAL requires entity_metadata with a location and scheduled_end_time.

Input Parameters

string
required
The name of the scheduled event (1-100 characters).
string
The cover image as a base64 data URI (e.g., ‘data:image/png;base64,…’).
string
required
The unique identifier (snowflake ID) of the Discord guild where the event will be created.
string
The channel ID where the event will be hosted. Required for STAGE_INSTANCE and VOICE entity types. Must be null for EXTERNAL.
string
The description of the scheduled event (1-1000 characters).
integer
required
The entity type: 1=STAGE_INSTANCE, 2=VOICE, 3=EXTERNAL.
integer
The privacy level of the event. Use 2 for GUILD_ONLY (only accessible to guild members).
object
Additional metadata for the guild scheduled event.
string
The time the event will end (ISO8601 timestamp). Required for EXTERNAL entity type.
string
required
The time the event will start (ISO8601 timestamp, e.g., ‘2024-12-31T20:00:00’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_STICKERUploads a PNG, APNG, GIF, or Lottie JSON file (max 512KB) as a new custom sticker to the specified Discord guild; requires Manage Expressions permission.

Input Parameters

object
required
Sticker file to upload (PNG, APNG, GIF, or Lottie JSON, max 512KB).
string
required
Name of the sticker (2-30 characters).
string
required
Autocomplete suggestion tags (comma-separated, max 200 characters) for the sticker; corresponds to the Discord emoji name.
string
required
ID of the guild to create the sticker for.
string
Description for the sticker (empty or 2-100 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_GUILD_TEMPLATECreates a template of an existing Discord guild’s structure (settings, roles, channels) but not its content (messages, members).

Input Parameters

string
required
Name for the new guild template (1-100 characters).
string
required
ID of the existing guild from which to create the template.
string
Optional description for the guild template (0-120 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_INTERACTION_RESPONSESends a response to a Discord interaction (e.g., slash command, component). Ensure response type is context-appropriate and initial reply is within 3 seconds.

Input Parameters

object
Data payload for an interaction callback response.
integer
required
Type of response: 1 (Pong), 4 (ChannelMessageWithSource), 5 (DeferredChannelMessageWithSource), 6 (DeferredMessageUpdate), 7 (UpdateMessage), 8 (AutocompleteResult), 9 (Modal).
string
required
ID of the originating user interaction (e.g., slash command, button).
string
required
Temporary token for responding to the interaction, valid for 15 minutes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_MESSAGESends a message to a Discord channel. Supports text content, embeds, stickers, components, and replies. Requires SEND_MESSAGES permission and at least one of content, embeds, sticker_ids, or components.

Input Parameters

boolean
Whether this is a text-to-speech message.
integer
Message flags (e.g., 4 for SUPPRESS_EMBEDS, 64 for EPHEMERAL).
array
Up to 10 embed objects. Each embed can contain title, description, url, timestamp, color, footer, image, thumbnail, video, provider, author, and fields.
string
Message text content (max 2000 characters). Required if embeds, sticker_ids, and components are all empty.
string
required
ID of the channel to send the message to.
array
Up to 5 action rows of interactive components (buttons, select menus).
array
Up to 3 sticker IDs accessible to the bot.
object
Controls which mentions in content trigger notifications. Keys: parse (list of ‘roles’, ‘users’, ‘everyone’), roles (list of role IDs), users (list of user IDs), replied_user (bool).
object
Reference for replying to a message. Requires message_id. Optional: channel_id, guild_id, fail_if_not_exists.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_STAGE_INSTANCECreates a new Stage instance in a Stage channel for hosting live audio events. Requires MANAGE_CHANNELS, MUTE_MEMBERS, and MOVE_MEMBERS permissions. A Stage channel can only have one active instance at a time.

Input Parameters

string
required
The topic/title of the Stage instance (1-120 characters).
string
required
The ID of the Stage channel (type 13) where the Stage instance will be created.
integer
The privacy level: 2 for GUILD_ONLY. Defaults to 2 if not specified.
boolean
Whether to send a notification to @everyone when the Stage starts. Requires MENTION_EVERYONE permission.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_THREADCreates a new thread in a text, announcement, forum, or media channel.

Input Parameters

string
required
The name of the thread (1-100 characters).
integer
The type of thread to create. 10 for announcement, 11 for public, 12 for private.
object
The initial message to send in the thread. Required for forum and media channels.
boolean
Whether non-moderators can add other non-moderators to the thread. Only for private threads.
string
required
The ID of the channel in which the new thread will be created.
array
Array of tag IDs to apply to the thread. Only for forum and media channels.
integer
Seconds a user must wait before sending another message (0-21600).
integer
Duration in minutes to automatically archive the thread after inactivity. Values: 60, 1440, 4320, 10080.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_THREAD_FROM_MESSAGECreates a new thread from a specific message in a Discord channel, requiring CREATE_PUBLIC_THREADS permission.

Input Parameters

string
required
The name for the new thread (1-100 characters).
string
required
The ID of the channel containing the message to create a thread from.
string
required
The ID of the message to create the thread from.
integer
Seconds a user must wait before sending another message in the thread (0-21600).
integer
Duration in minutes to automatically archive the thread after inactivity. Accepted values: 60, 1440, 4320, 10080.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CREATE_WEBHOOKCreates a new webhook in a specified Discord channel, requiring MANAGE_WEBHOOKS permission.

Input Parameters

string
required
Name for the webhook (1-80 characters).
string
Base64-encoded image data URI for the webhook avatar (e.g. ‘data:image/png;base64,…’).
string
required
The ID of the channel to create the webhook in.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_CROSSPOST_MESSAGECrossposts a message from an announcement channel to all channels following it. The message must not have been previously crossposted and must not be a system message.

Input Parameters

string
required
ID of the announcement channel containing the message to crosspost.
string
required
ID of the message to crosspost to all following channels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONSRemoves all reactions from a message. Requires MANAGE_MESSAGES permission. This removes reactions from all users, not just the bot.

Input Parameters

string
required
ID of the channel containing the message.
string
required
ID of the message to remove all reactions from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJIRemoves all reactions for a specific emoji from a message. Requires MANAGE_MESSAGES permission. Removes reactions from all users, not just the bot.

Input Parameters

string
required
Emoji to remove all reactions for. For Unicode emojis use the character directly (e.g., ’👍’). For custom emojis use ‘name:id’ format.
string
required
ID of the channel containing the message.
string
required
ID of the message to remove reactions from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_APPLICATION_COMMANDDEPRECATED: This tool is no longer available. Use the guild application command tools, which register commands in the connected server. Permanently deletes a global application command. This is irreversible and the command will no longer appear in Discord clients. Global command deletions can take up to 1 hour to propagate.

Input Parameters

string
required
The unique identifier (snowflake ID) of the command to permanently delete.
string
required
The unique identifier (snowflake ID) of the Discord application that owns the command.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_AUTO_MODERATION_RULEPermanently deletes a specific auto moderation rule from a Discord guild. Requires MANAGE_GUILD permission.

Input Parameters

string
required
The unique identifier (snowflake ID) of the auto moderation rule to delete.
string
required
The unique identifier (snowflake ID) of the Discord guild containing the rule.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_CHANNELPermanently deletes a Discord channel by its ID. This action is irreversible. Returns the deleted channel object (not 204).

Input Parameters

string
required
The unique identifier of the Discord channel to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_CHANNEL_PERMISSION_OVERWRITERemoves channel-specific permission overwrites for a user or role, reverting them to default permissions inherited from the server or category. Requires MANAGE_ROLES permission. This action is irreversible.

Input Parameters

string
required
ID of the Discord guild channel from which the permission overwrite will be removed.
string
required
ID of the user or role whose permission overwrite will be deleted from the channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GROUP_DM_USERDEPRECATED: This tool is not supported. Discord requires a user token for group DMs, which a bot connection does not have. Removes a recipient from a Discord group DM channel. Requires OAuth2 user access tokens with the gdm.join scope. Only the group DM owner or managing application can remove recipients.

Input Parameters

string
required
The unique identifier of the user to be removed from the group DM channel.
string
required
The unique identifier of the group DM channel from which the user will be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILDPermanently deletes the connected Discord guild (server). The authenticated user must be the guild owner; this action is irreversible.

Input Parameters

string
required
The unique identifier of the Discord guild (server) to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_APPLICATION_COMMANDPermanently deletes a guild-specific application command in the connected server. This is irreversible.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild.
string
required
The unique identifier (snowflake ID) of the command to permanently delete.
string
required
The unique identifier (snowflake ID) of the Discord application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_EMOJIPermanently deletes a specified custom emoji from a guild, requiring Manage Expressions permissions; cannot delete default emojis and is irreversible.

Input Parameters

string
required
The unique identifier of the custom emoji to be deleted from the guild.
string
required
The unique identifier of the Discord guild (server) from which the emoji will be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_INTEGRATIONPermanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present. Requires MANAGE_GUILD permission.

Input Parameters

string
required
The unique identifier of the Discord guild from which the integration will be deleted.
string
required
The unique identifier of the integration to be deleted from the guild.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_MEMBERRemoves (kicks) a member from a Discord guild. The user must be an existing member of the specified guild. Requires KICK_MEMBERS permission.

Input Parameters

string
required
The unique identifier (snowflake ID) of the user to be removed from the guild.
string
required
The unique identifier (snowflake ID) of the Discord guild from which the member will be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_MEMBER_ROLERemoves a specified role from a member of a Discord guild. Requires MANAGE_ROLES permission and the role must be lower in hierarchy than the bot’s highest role. Idempotent - succeeds even if member does not have the role.

Input Parameters

string
required
The unique identifier (snowflake ID) of the role to be removed from the guild member.
string
required
The unique identifier (snowflake ID) of the user whose role is to be removed.
string
required
The unique identifier (snowflake ID) of the Discord guild from which the member’s role will be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_ROLEPermanently 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.

Input Parameters

string
required
The unique identifier (snowflake ID) of the role to be deleted.
string
required
The unique identifier (snowflake ID) of the Discord guild from which the role will be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_SCHEDULED_EVENTPermanently deletes a specific scheduled event from a Discord guild. This action is irreversible.

Input Parameters

string
required
The unique identifier (snowflake ID) of the scheduled event to delete.
string
required
The unique identifier (snowflake ID) of the Discord guild containing the event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_STICKERPermanently deletes a custom sticker from a Discord guild; the specified guild and sticker must exist, and this action is irreversible.

Input Parameters

string
required
The unique identifier of the Discord guild from which the sticker will be deleted.
string
required
The unique identifier of the sticker to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_GUILD_TEMPLATEDeletes an existing guild template by its unique code from a specified guild, returning the deleted template’s details.

Input Parameters

string
required
The ID of the guild from which the template will be deleted.
string
required
The unique code of the guild template to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_MESSAGEPermanently deletes a message from a Discord channel. The bot can delete its own messages or, with MANAGE_MESSAGES permission, delete messages from other users.

Input Parameters

string
required
ID of the channel containing the message to delete.
string
required
ID of the message to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_MY_MESSAGE_REACTIONRemoves the bot’s own emoji reaction from a message. Only removes the bot’s reaction, not other users’ reactions.

Input Parameters

string
required
Emoji to remove. For Unicode emojis use the character directly (e.g., ’👍’). For custom emojis use ‘name:id’ format (e.g., ‘myemoji:123456789012345678’).
string
required
ID of the channel containing the message.
string
required
ID of the message to remove the reaction from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_ORIGINAL_WEBHOOK_MESSAGEPermanently deletes the original (@original) message posted by a webhook or interaction response.

Input Parameters

string
ID of the thread where the original message is located, if applicable.
string
required
The webhook or application ID.
string
required
The webhook or interaction token.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_STAGE_INSTANCEPermanently deletes the Stage instance for a given stage channel, ending the live audio event.

Input Parameters

string
required
The unique identifier (snowflake ID) of the stage channel whose Stage instance is to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_THREAD_MEMBERRemoves a user from a specified, unarchived thread. Requires MANAGE_THREADS permission.

Input Parameters

string
required
The ID of the user to remove from the thread.
string
required
The ID of the thread from which the user will be removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_USER_MESSAGE_REACTIONRemoves a specific user’s emoji reaction from a message. Requires MANAGE_MESSAGES permission.

Input Parameters

string
required
Emoji to remove. For Unicode emojis use the character directly (e.g., ’👍’). For custom emojis use ‘name:id’ format.
string
required
ID of the user whose reaction to remove.
string
required
ID of the channel containing the message.
string
required
ID of the message to remove the reaction from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_WEBHOOKPermanently deletes a Discord webhook by its unique ID. This action is irreversible.

Input Parameters

string
required
The unique identifier of the webhook to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_WEBHOOK_BY_TOKENPermanently deletes a Discord webhook using its ID and token.

Input Parameters

string
required
The unique identifier of the webhook to delete.
string
required
The secret token of the webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_DELETE_WEBHOOK_MESSAGEDeletes a message previously sent by a Discord webhook.

Input Parameters

string
ID of the thread the message is in, if applicable.
string
required
The ID of the message to delete.
string
required
The unique ID of the webhook.
string
required
The secret token for the webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_EXECUTE_GITHUB_COMPATIBLE_WEBHOOKForwards GitHub event notifications to a Discord channel via a GitHub-compatible webhook endpoint.

Input Parameters

string
Git reference involved in the event (e.g. ‘refs/heads/main’).
boolean
If true, waits for message confirmation before responding.
object
GitHub issue object for issue-related events.
string
Type of action that triggered the GitHub event (e.g. ‘opened’, ‘created’).
object
Answer object for GitHub Discussions answer events.
boolean
Whether the push was a force push.
object
New repository object created in fork events.
object
GitHub member/user object for member-related events.
object
GitHub pull request review object for review events.
object
GitHub user/application that triggered the event.
object
GitHub comment object for comment-related events.
array
List of commit details for push events.
string
URL to view the comparison of changes.
object
GitHub release object for release events.
string
Type of the Git reference (e.g. ‘branch’, ‘tag’).
object
GitHub Check Run object for CI/CD events.
string
ID of a target Discord thread for the message.
object
GitHub Discussion object for discussion events.
object
GitHub repository object containing repo metadata.
string
required
The unique identifier of the Discord webhook.
object
GitHub Check Suite object for grouped check runs.
object
Most recent commit object in push events.
object
GitHub pull request object for PR-related events.
string
required
The secret token for the Discord webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_EXECUTE_SLACK_COMPATIBLE_WEBHOOKSends messages to Discord via its Slack-compatible webhook endpoint, supporting Slack attachment formatting.

Input Parameters

string
The main message content (max 2000 characters). Supports Slack mrkdwn formatting.
boolean
If true, waits for server confirmation before responding.
string
URL for the avatar icon, overriding the default webhook icon.
string
Override the default webhook username (max 80 characters).
string
ID of a target thread within the channel to send the message to.
string
required
The unique identifier of the Discord webhook.
array
Up to 10 Slack-style attachment objects for rich formatting.
string
required
The secret token for the Discord webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_EXECUTE_WEBHOOKExecutes a Discord webhook to send a message to a channel or thread, with optional embeds or interactive components. At least one of content, embeds, or a poll must be provided.

Input Parameters

boolean
Send as a text-to-speech message.
object
A poll object to attach to the message.
boolean
If true, waits for server confirmation and returns a message object. Defaults to true.
integer
Message flags bitfield (e.g. 4 for SUPPRESS_EMBEDS, 4096 for SUPPRESS_NOTIFICATIONS).
array
Up to 10 embed objects for rich content.
string
Message text content (max 2000 characters).
string
Override the default username of the webhook (max 80 characters).
string
ID of a thread in the webhook’s channel to send the message to.
string
Override the default avatar of the webhook with a URL to an image.
array
Message components (buttons, select menus), up to 5 action rows.
string
required
The unique ID of the Discord webhook.
string
Name of a thread to create when executing on a forum channel (max 100 characters).
array
Array of tag IDs to apply to a forum thread (only works with thread_name).
string
required
The secret token for the Discord webhook.
object
Controls which mentions in content actually ping recipients.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_FOLLOW_CHANNELFollows an Announcement Channel to relay its messages to a target channel via webhook. Both channels must belong to the connected server, and the bot must have MANAGE_WEBHOOKS permission in the target channel.

Input Parameters

string
required
The ID of the Announcement Channel (type 5) to follow. This is the source channel whose messages will be relayed.
string
required
The ID of the target channel where messages from the followed Announcement Channel will be posted. Requires MANAGE_WEBHOOKS permission.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_ACTIVE_GUILD_THREADSRetrieves all active (non-archived) threads in a Discord guild that the bot can access.

Input Parameters

string
required
The ID of the guild to retrieve active threads from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_APPLICATIONRetrieves the full details of a Discord application by its application_id.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord application to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_APPLICATION_COMMANDRetrieves a specific global application command by its application ID and command ID.

Input Parameters

string
required
The unique identifier (snowflake ID) of the command to retrieve.
string
required
The unique identifier (snowflake ID) of the Discord application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_APPLICATION_ROLE_CONNECTIONS_METADATARetrieves all role connection metadata records for a Discord application. Returns an empty list if none are configured.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_APPLICATION_USER_ROLE_CONNECTIONFetches the role connection object for the current user for a specified Discord application. Requires OAuth2 with the role_connections.write scope.

Input Parameters

string
required
The unique ID of the Discord application for which the user’s role connection information is being requested.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_AUTO_MODERATION_RULERetrieves the complete configuration of a specific auto moderation rule within a Discord guild.

Input Parameters

string
required
The unique identifier (snowflake ID) of the auto moderation rule to retrieve.
string
required
The unique identifier (snowflake ID) of the Discord guild.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_BOT_GATEWAYRetrieves the WSS URL, recommended shard count, and session start limits for connecting a bot to the Discord Gateway.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_CHANNELRetrieves detailed metadata for a specific Discord channel by its channel_id. Returns only channel metadata, not message content or member lists.

Input Parameters

string
required
The ID of the Discord channel to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_CONNECTED_GUILDReturns the Discord server this bot connection was installed in.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GATEWAYRetrieves the WebSocket URL to connect to Discord’s Gateway for receiving real-time events. This is a public endpoint that does not require authentication.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILDRetrieves detailed information for the connected Discord guild (server) by its guild ID, optionally including approximate member and presence counts when requested.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild (server) to retrieve.
boolean
When true, includes approximate member and presence counts for the guild.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_APPLICATION_COMMANDRetrieves detailed information for a specific application command within the connected Discord guild.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild.
string
required
The unique identifier (snowflake ID) of the command to retrieve.
string
required
The unique identifier (snowflake ID) of the Discord application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_APPLICATION_COMMAND_PERMISSIONSRetrieves the permissions for a specific application command within a guild.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild.
string
required
The unique identifier (snowflake ID) of the command.
string
required
The unique identifier (snowflake ID) of the Discord application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_BANFetches the ban details for a specific user in a Discord guild, if that user is currently banned.

Input Parameters

string
required
The ID of the user to retrieve ban details for.
string
required
The ID of the guild.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_EMOJIRetrieves details for a specific custom emoji within a specified Discord guild, requiring valid and accessible guild and emoji IDs.

Input Parameters

string
required
The unique identifier of the custom emoji to retrieve.
string
required
The unique identifier (snowflake ID) of the Discord guild (server) from which to fetch the emoji.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_MEMBERRetrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord user whose guild member information is to be retrieved.
string
required
The unique identifier (snowflake ID) of the Discord guild (server) from which to fetch the member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_PREVIEWFetches a public preview of the connected Discord guild by its ID.

Input Parameters

string
required
The unique identifier of the Discord guild (server) to preview.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_SCHEDULED_EVENTRetrieves a specific scheduled event from a Discord guild by its ID, optionally including the count of subscribed users.

Input Parameters

string
required
The unique identifier (snowflake ID) of the scheduled event to retrieve.
string
required
The unique identifier (snowflake ID) of the Discord guild containing the event.
boolean
When true, includes the count of users subscribed to the event in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILDS_ONBOARDINGRetrieves the onboarding settings for a specified Discord guild, including prompts, options, default channels, and enabled status.

Input Parameters

string
required
The unique identifier of the Discord guild for which to retrieve onboarding information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_STICKERRetrieves a specific sticker from a Discord guild using the guild and sticker IDs; requires the sticker to exist in the guild.

Input Parameters

string
required
The snowflake ID of the Discord guild (server) from which to retrieve the sticker.
string
required
The snowflake ID of the sticker to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_TEMPLATERetrieves the complete structure and details of a Discord guild template using its unique code.

Input Parameters

string
required
The unique code of the guild template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_VANITY_URLRetrieves the vanity URL invite code and usage count for a Discord guild. Requires MANAGE_GUILD permission and the VANITY_URL feature.

Input Parameters

string
required
The unique identifier of the Discord guild for which to retrieve the vanity URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_WEBHOOKSRetrieves all webhooks for a specified Discord guild, requiring MANAGE_WEBHOOKS permission.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild for which to retrieve webhooks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_WELCOME_SCREENRetrieves the welcome screen configuration for a Discord guild with the Community feature enabled. Returns the welcome screen description and up to 5 suggested channels.

Input Parameters

string
required
The unique snowflake ID of the Discord guild to retrieve the welcome screen for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_WIDGETRetrieves the public JSON widget data for a Discord guild, if the widget is enabled for that guild.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild for which to retrieve the widget JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_WIDGET_PNGTool to retrieve a PNG image widget for a Discord guild. Use when you need a visual representation of the guild widget that can be displayed on external websites. The widget must be enabled in the guild’s server settings.

Input Parameters

string ("shield" | "banner1" | "banner2" | "banner3" | "banner4")
Customizes the visual appearance of the widget image. Options: ‘shield’ (compact badge-style), ‘banner1’, ‘banner2’, ‘banner3’, ‘banner4’ (various horizontal banner formats).
string
required
The unique identifier of the guild (snowflake ID).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_GUILD_WIDGET_SETTINGSRetrieves the widget settings for a specified Discord guild, indicating if the widget is enabled and its configured channel ID.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild for which to retrieve widget settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_MESSAGERetrieves a specific message from a Discord channel by channel and message ID.

Input Parameters

string
required
The ID of the Discord channel containing the message.
string
required
The ID of the message to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_MY_APPLICATIONRetrieves detailed information about the current authenticated Discord application via /applications/@me. Available only with a custom Discord application, not the Composio-managed bot.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_MY_OAUTH2_APPLICATIONRetrieves detailed information about the OAuth2 application associated with the current authentication. Available only with a custom Discord application, not the Composio-managed bot.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_ORIGINAL_WEBHOOK_MESSAGERetrieves the original (@original) message from a Discord webhook or interaction response.

Input Parameters

string
ID of the thread where the original message was posted, if applicable.
string
required
The webhook or application ID. For interaction responses, this is the bot’s application ID.
string
required
The webhook or interaction token. For interactions, valid for 15 minutes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_PUBLIC_KEYSRetrieves Discord’s OAuth2 public keys in JWK format for verifying access tokens. Keys may rotate, so refresh caches periodically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_STAGE_INSTANCERetrieves the active Stage instance for a specified stage channel. Returns 404 if no active Stage instance exists.

Input Parameters

string
required
The unique identifier (snowflake ID) of the stage channel whose active Stage instance is to be retrieved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_STICKERRetrieves a specific Discord sticker by its unique ID.

Input Parameters

string
required
The unique identifier (snowflake ID) of the sticker to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_THREAD_MEMBERRetrieves a member from a specified thread using their user ID, optionally including guild member details.

Input Parameters

string
required
The ID of the user whose membership in the thread is being retrieved.
string
required
The ID of the thread.
boolean
If true, includes the full guild member object in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_USERFetches public information for a Discord user by their user ID.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord user to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_WEBHOOKRetrieves detailed information for a Discord webhook by its unique ID.

Input Parameters

string
required
The unique identifier of the Discord webhook to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_WEBHOOK_BY_TOKENRetrieves a Discord webhook’s configuration using its ID and token.

Input Parameters

string
required
The unique identifier of the Discord webhook.
string
required
The secret token for the Discord webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_GET_WEBHOOK_MESSAGERetrieves a specific message previously sent by a Discord webhook.

Input Parameters

string
ID of the thread if the message is part of one.
string
required
The unique ID of the message to retrieve.
string
required
The unique ID of the webhook that sent the message.
string
required
The secret token for the webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_INVITE_RESOLVEResolves an invite code for the connected Discord server, optionally requesting member counts and expiration details.

Input Parameters

string
required
The unique invite code (e.g. ‘nYUs4yAE’ from ‘discord.gg/nYUs4yAE’).
boolean
If true, include approximate member and presence counts.
boolean
If true, include the expiration date of the invite.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_INVITE_REVOKERevokes an invite for the connected Discord server using its code, preventing new joins via the link.

Input Parameters

string
required
The unique code of the Discord invite to revoke.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_JOIN_THREADJoins the authenticated user to a thread specified by channel_id.

Input Parameters

string
required
The ID of the thread to join.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LEAVE_GUILDMakes the bot leave its connected Discord server. The bot must be re-invited to rejoin.

Input Parameters

string
required
The unique identifier of the Discord guild (server) the bot wishes to leave.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LEAVE_THREADRemoves the currently authenticated user from a specified thread.

Input Parameters

string
required
The ID of the thread to leave.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_APPLICATION_COMMANDSFetches all global application commands for the specified Discord application. Does not include guild-specific commands.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord application.
boolean
Whether to include full localization dictionaries in the returned command objects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_AUTO_MODERATION_RULESRetrieves all auto moderation rules for a specified Discord guild. Requires MANAGE_GUILD permission.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild whose auto moderation rules to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_CHANNEL_INVITESFetches all active invites for a given Discord channel. Requires MANAGE_CHANNELS permission.

Input Parameters

string
required
The ID of the channel to retrieve invites for. Requires MANAGE_CHANNELS permission.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_CHANNEL_WEBHOOKSRetrieves all webhooks configured in a given Discord channel. Requires the MANAGE_WEBHOOKS permission.

Input Parameters

string
required
The unique identifier of the Discord channel to list webhooks for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_APPLICATION_COMMAND_PERMISSIONSRetrieves all guild-level permission settings for all commands of a specific application within a guild.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild.
string
required
The unique identifier (snowflake ID) of the Discord application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_APPLICATION_COMMANDSFetches guild-specific application commands for a specified application and Discord guild. Does not include global commands.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild to list commands for.
string
required
The unique identifier (snowflake ID) of the Discord application.
boolean
Whether to include full localization dictionaries in the returned command objects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_AUDIT_LOG_ENTRIESRetrieves audit log entries for a specified Discord guild, requiring VIEW_AUDIT_LOG permission. Supports filtering by user, action type, and pagination.

Input Parameters

string
Retrieve audit log entries after this entry ID for pagination.
integer
Maximum number of audit log entries to return (1-100). Defaults to 50.
string
Retrieve audit log entries before this entry ID for pagination.
string
Filter logs by the ID of the user who performed the action.
string
required
ID of the Discord guild for which to retrieve audit logs.
integer
Filter logs by a specific audit log event type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_BANSFetches a list of users banned from a specified Discord guild. Requires BAN_MEMBERS permission.

Input Parameters

string
Fetch bans for users with IDs after this user ID. For forward pagination.
integer
Maximum number of bans to return (1-1000).
string
Fetch bans for users with IDs before this user ID. For backward pagination.
string
required
The ID of the guild to retrieve bans from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_CHANNELSFetches all channels (text, voice, category, etc.) for a specified Discord guild. Does not include threads or message content.

Input Parameters

string
required
Identifier of the Discord guild (server) whose channels to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_EMOJISFetches 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.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild (server) for which to list emojis.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_INTEGRATIONSLists all integration objects for a specified Discord guild. Requires MANAGE_GUILD permission.

Input Parameters

string
required
The unique identifier of the Discord guild for which to list integrations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_INVITESRetrieves all currently active invite codes for a specified Discord guild.

Input Parameters

string
required
The ID of the guild to retrieve active invites from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_MEMBERSRetrieves a list of members for a Discord guild. Requires GUILD_MEMBERS intent. Supports pagination via limit and after parameters.

Input Parameters

string
User ID for pagination offset; fetches members with IDs greater than this value.
integer
Max number of members to return (1-1000). Defaults to 1 if not specified.
string
required
The unique identifier (snowflake ID) of the Discord guild (server) to retrieve members from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_ROLESFetches all roles in a Discord guild, providing details for each role including permissions, color, position, and other attributes.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild (server) to retrieve roles from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_SCHEDULED_EVENTSRetrieves a list of scheduled events for a specified Discord guild, optionally including subscribed user counts.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild whose scheduled events to list.
boolean
When true, includes the count of users subscribed to each scheduled event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_SCHEDULED_EVENT_USERSFetches users who have expressed interest in a specific scheduled event within a Discord guild. Supports pagination and optional guild member data.

Input Parameters

string
Return users after this user ID for pagination.
integer
Maximum number of users to return (1-100). Defaults to 100 if not specified.
string
Return users before this user ID for pagination.
string
required
The unique identifier (snowflake ID) of the scheduled event.
string
required
The unique identifier (snowflake ID) of the Discord guild.
boolean
When true, includes the guild member object for each user in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_STICKERSRetrieves all custom sticker objects for a Discord guild; does not include standard/Nitro stickers.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild (server) for which to list stickers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_TEMPLATESRetrieves all guild templates for an existing Discord guild, specified by its ID. Requires MANAGE_GUILD permission.

Input Parameters

string
required
The unique identifier of the Discord guild for which to retrieve templates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_GUILD_VOICE_REGIONSFetches a list of available voice regions for a specified Discord guild.

Input Parameters

string
required
The unique identifier of the Discord guild (server).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJILists users who reacted to a message with a specific emoji. Supports pagination.

Input Parameters

string
Get users after this user ID, for pagination.
string
required
Emoji to get reactions for. For Unicode emojis use the character directly (e.g., ’👍’). For custom emojis use ‘name:id’ format.
integer
Max number of users to return (1-100, defaults to 25).
string
required
ID of the channel containing the message.
string
required
ID of the message to retrieve reactions from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_MESSAGESRetrieves messages from a Discord channel, ordered newest first. Supports pagination via before/after/around parameters.

Input Parameters

string
Get messages after this message ID for forward pagination.
integer
Max number of messages to return (1-100, defaults to 50).
string
Get messages around this message ID.
string
Get messages before this message ID for backward pagination.
string
required
ID of the Discord channel to fetch messages from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_MY_GUILDSDEPRECATED: This tool is no longer available. A Discord Bot connection works within the server it was installed in. Use DISCORDBOT_GET_CONNECTED_GUILD to read that server. Lists Discord guilds accessible to the authenticated bot, with cursor pagination and optional approximate member and presence counts.

Input Parameters

string
Return guilds after this guild snowflake for forward pagination.
integer
Maximum number of guilds to return (1-200).
string
Return guilds before this guild snowflake for backward pagination.
boolean
Whether to include approximate member and online-presence counts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_MY_PRIVATE_ARCHIVED_THREADSRetrieves private archived threads from a channel that the current user is a member of.

Input Parameters

integer
Maximum number of threads to return (1-100).
string
ISO8601 timestamp or thread ID. Returns threads archived before this value.
string
required
The ID of the channel to retrieve private archived threads from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_PINNED_MESSAGESRetrieves all pinned messages from a Discord channel. Returns up to 50 pinned messages.

Input Parameters

string
required
ID of the Discord channel to retrieve pinned messages from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_PRIVATE_ARCHIVED_THREADSLists private archived threads in a Discord channel, sorted by most recent archival. Requires view access.

Input Parameters

integer
Maximum number of threads to return (1-100).
string
ISO8601 timestamp or thread ID. Returns threads archived before this value.
string
required
The ID of the channel to retrieve private archived threads from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_PUBLIC_ARCHIVED_THREADSLists public archived threads in a Discord channel, sorted by most recent archival.

Input Parameters

integer
Maximum number of threads to return (1-100).
string
ISO8601 timestamp or thread ID. Returns threads archived before this value.
string
required
The ID of the channel to retrieve public archived threads from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_STICKER_PACKSFetches all available Nitro sticker packs from Discord, excluding custom or guild-specific sticker packs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_THREAD_MEMBERSRetrieves members of a specified Discord thread, with an option to include full guild member objects.

Input Parameters

string
User ID to paginate from, returning members after this ID.
integer
Maximum number of thread members to return (1-100).
string
required
The ID of the thread to retrieve members from.
boolean
If true, includes the full guild member object for each thread member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_LIST_VOICE_REGIONSLists all available Discord voice regions that can be used when setting a voice or stage channel’s region.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_PIN_MESSAGEPins a message in a Discord channel. Requires MANAGE_MESSAGES permission. A channel can have at most 50 pinned messages.

Input Parameters

string
required
ID of the channel containing the message to pin.
string
required
ID of the message to pin. Channel cannot exceed 50 pinned messages.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_PREVIEW_PRUNE_GUILDPreviews the number of members that would be pruned from a Discord guild based on inactivity days and optional roles; does not remove members.

Input Parameters

integer
Number of days of inactivity (1-30). Defaults to 7 if not specified.
string
required
The unique identifier of the Discord guild for which to preview the prune operation.
array
List of role IDs to include when calculating prune count. By default, members with roles are not counted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_PRUNE_GUILDRemoves inactive members from a Discord guild. Requires KICK_MEMBERS permission. Set compute_prune_count=false for large guilds to avoid timeouts.

Input Parameters

integer
Number of days a member must be inactive (1-30, default 7) to be eligible for pruning.
string
required
ID of the Discord guild for member pruning.
array
List of role IDs. Members with a subset of these roles who are inactive will be pruned.
boolean
If true (default), returns the actual count of pruned members. If false, returns null (recommended for large guilds).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_PUT_GUILDS_ONBOARDINGConfigures or updates a Discord guild’s new member onboarding flow, including prompts, options, default channels, and enabled status.

Input Parameters

integer
Onboarding mode (0 = ONBOARDING_DEFAULT, 1 = ONBOARDING_ADVANCED).
boolean
If true, the guild’s onboarding flow is active.
array
Up to 5 onboarding prompts for the guild.
string
required
Guild’s unique ID (snowflake) for which onboarding settings are being updated.
array
Up to 7 channel IDs new members join post-onboarding.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_REORDER_GUILD_ROLESSets one or more Discord guild role positions and returns the resulting complete role order. Requires MANAGE_ROLES permission.

Input Parameters

string
required
The unique identifier (snowflake ID) of the guild.
array
required
Roles to reorder. Each entry requires a role ID and may include its new integer position or null.
string
Reason to record in the guild audit log (1-512 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_SEARCH_GUILD_MEMBERSSearches for members in a specific Discord guild by matching a query string against usernames and nicknames. Returns matching guild member objects.

Input Parameters

integer
Maximum number of members to return (1-1000). Defaults to 1 if not specified.
string
required
The query string to match against usernames or nicknames. The search is prefix-based (e.g., ‘adm’ will match ‘admin’).
string
required
The unique identifier (snowflake ID) of the Discord guild (server) to search within.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_SEARCH_GUILD_MESSAGESSearch messages across a Discord guild and preserve hit/context groupings.

Input Parameters

integer
Maximum number of result groups to return, from 1 through 25.
string
Newest message snowflake boundary to include.
string
Oldest message snowflake boundary to include.
integer
Result offset from 0 through 9975.
string
Message text to search for, up to 1024 characters.
string ("relevance" | "timestamp")
Rank results by relevance or message timestamp.
string
required
Guild snowflake to search.
array
One to 100 unique author snowflakes to include.
array
One to 500 unique channel snowflakes to search within.
string ("asc" | "desc")
Return results in ascending or descending order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_SET_CHANNEL_PERMISSION_OVERWRITEUpdates or creates a permission overwrite for a role (type 0) or member (type 1) within a Discord channel using allow and deny bitwise values. Requires MANAGE_ROLES permission.

Input Parameters

string
Bitwise value of Discord permission flags to deny as a string. ‘0’ means no explicit denials.
integer
required
Type of entity overwrite_id refers to: 0 for a role or 1 for a member (user).
string
Bitwise value of Discord permission flags to grant as a string. ‘0’ means no new permissions.
string
required
The unique identifier of the Discord channel where the permission overwrite will be applied.
string
required
The unique identifier of the role or member (user) to whom the permission overwrite applies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_SYNC_GUILD_TEMPLATESynchronizes a guild template with its source guild, updating it to match the source’s current configuration; does not affect guilds already created from this template.

Input Parameters

string
required
The unique identifier of the Discord guild that is the source of the template.
string
required
The unique code of the guild template to be synchronized.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_TEST_AUTHTool to validate the configured Discord bot token by fetching the current authenticated bot user. Use when diagnosing repeated 401 errors to determine if the issue is an invalid token (this endpoint returns 401) or missing guild membership/permissions/wrong channel_id (this endpoint returns 200 but other operations fail).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_TRIGGER_TYPING_INDICATORShows the bot is typing in a Discord channel. The indicator stops after 10 seconds or upon message send. Use when actively preparing a response.

Input Parameters

string
required
The unique identifier of the Discord channel where the typing indicator should be displayed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UNBAN_USER_FROM_GUILDRevokes a ban for a user from a Discord guild, allowing them to rejoin. Requires BAN_MEMBERS permission.

Input Parameters

string
required
The ID of the user to unban.
string
required
The ID of the guild to remove the ban from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UNPIN_MESSAGEUnpins a message from a Discord channel. The message is not deleted, only removed from the pinned list. Requires MANAGE_MESSAGES permission.

Input Parameters

string
required
ID of the channel containing the pinned message.
string
required
ID of the message to unpin.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_APPLICATIONDEPRECATED: This tool is no longer available. The bot’s profile and application settings are managed in the Discord Developer Portal. Updates a Discord application’s settings using its application_id.

Input Parameters

string
Base64 encoded application icon (PNG, JPEG, or GIF).
array
Up to 5 tags describing the application (max 20 chars each).
integer
Bitwise application flags value.
string
Base64 encoded cover image (PNG, JPEG, or GIF).
string
New description for the application.
string
required
The unique identifier (snowflake ID) of the Discord application to update.
integer
Max participants for an embedded activity.
string
Custom URL for post-authorization redirection.
string
HTTPS URL for Discord to send interaction events.
string
URL for role connection verification.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_APPLICATION_COMMANDDEPRECATED: This tool is no longer available. Use the guild application command tools, which register commands in the connected server. Updates properties of a global application command. Omitted properties remain unchanged. The options field, if provided, overwrites all existing options.

Input Parameters

string
New name for the command (1-32 characters).
array
New list of command option objects. If provided, all existing options are overwritten.
string
required
The unique identifier (snowflake ID) of the command to update.
string
New description for the command (1-100 characters). Empty string for USER/MESSAGE commands.
boolean
Whether the command is available in DMs with the app.
string
required
The unique identifier (snowflake ID) of the Discord application.
object
Localization dictionary mapping locale codes to localized names.
object
Localization dictionary mapping locale codes to localized descriptions.
string
Bitwise permission flags string. ‘0’ disables for non-admins. Null allows everyone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_APPLICATION_USER_ROLE_CONNECTIONDEPRECATED: This tool is no longer available. The bot’s profile and application settings are managed in the Discord Developer Portal. Updates the current user’s application role connection metadata for Discord’s Linked Roles feature. Requires OAuth2 with the role_connections.write scope.

Input Parameters

object
A dictionary of custom metadata key-value pairs. Keys must match metadata keys configured in the application’s role connection metadata schema. Maximum 5 entries.
string
The vanity name of the platform to display in Discord’s user profile (max 50 characters).
string
required
The unique Discord application ID (snowflake). Must have linked role connection metadata configured.
string
The user’s username on the external platform (max 100 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_AUTO_MODERATION_RULEUpdates an existing auto moderation rule in a Discord guild. Only fields provided in the request body are changed. Requires MANAGE_GUILD permission.

Input Parameters

string
The name of the rule (1-100 characters).
array
The actions to execute when the rule is triggered (max 5).
boolean
Whether the rule is enabled.
string
required
The unique identifier (snowflake ID) of the auto moderation rule to update.
string
required
The unique identifier (snowflake ID) of the Discord guild containing the rule.
integer
The event type: 1=MESSAGE_SEND, 2=MEMBER_UPDATE.
array
Role IDs not affected by the rule (max 20).
array
Channel IDs not affected by the rule (max 50).
object
Additional metadata associated with the rule’s trigger type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_CHANNELUpdates a Discord channel’s settings (name, topic, permissions, etc.). Requires MANAGE_CHANNELS permission. All body parameters are optional — only include fields you want to change.

Input Parameters

string
New channel name (1-100 characters).
boolean
Whether the channel is age-restricted (NSFW).
integer
Channel type. Only conversion between text (0) and announcement (5) is supported.
integer
Channel flags bitfield.
string
Channel topic (0-1024 chars for text/announcement, 0-4096 for forum/media).
integer
Bitrate in bits per second for voice/stage channels (8000-384000).
integer
Sorting position of the channel in the guild.
string
ID of the parent category channel (null to remove from category).
string
required
The unique identifier of the Discord channel to modify.
string
Voice region ID (null for automatic selection).
integer
Maximum users in a voice channel (0=unlimited, 1-99).
array
Tags available in a forum/media channel (max 20).
integer
Default sort order for forum posts (0=latest activity, 1=creation date).
integer
Camera video quality mode (1=auto, 2=720p).
integer
Slowmode rate limit in seconds per user (0-21600).
integer
Default forum layout (0=not set, 1=list view, 2=gallery view).
array
Channel-specific permission overwrites for roles and members.
object
Default reaction emoji for forum posts.
integer
Default thread auto-archive duration in minutes (60, 1440, 4320, 10080).
integer
Initial rate_limit_per_user for new threads (0-21600 seconds).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILDUpdates settings for the connected Discord guild (server), requiring MANAGE_GUILD permission. All parameters except guild ID are optional; include only the settings you want to change.

Input Parameters

string
Base64 encoded 128x128 image data URL for the guild icon. Set to null to remove.
string
New name for the guild (2-100 characters).
string
Base64 encoded 16:9 image for guild banner (requires BANNER feature). Set to null to remove.
string
Voice region ID for the guild (deprecated). Set to null for automatic.
string
Base64 encoded 16:9 image for guild invite splash (requires INVITE_SPLASH feature). Set to null to remove.
array
List of guild feature strings to enable (e.g. COMMUNITY, DISCOVERABLE).
string
required
The ID of the guild (server) to update (snowflake).
string
User ID to transfer guild ownership to. Requires being the current owner.
integer
AFK timeout in seconds (60, 300, 900, 1800, 3600).
string
New description for the guild. Set to null to remove.
string
Base64 encoded image for guild home header (requires COMMUNITY feature). Set to null to remove.
string
ID of the AFK channel; null to disable.
string
Base64 encoded image for guild discovery splash (requires DISCOVERABLE feature). Set to null to remove.
string
Preferred locale for server discovery and Discord notices (e.g. en-US).
string
ID of the channel for server rules (requires COMMUNITY feature); null to disable.
string
ID of the channel for guild notices; null to disable.
integer
Verification level (0: None, 1: Low, 2: Medium, 3: High, 4: Very High).
integer
System channel flags as an integer bitfield.
integer
Explicit content filter level (0: Disabled, 1: Members without roles, 2: All members).
string
ID of the channel for Discord safety alerts; null to disable.
string
ID of the channel for Discord notices to admins; null to disable.
boolean
Whether to display the server boost progress bar.
integer
Default message notification level (0: All Messages, 1: Only @mentions).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_APPLICATION_COMMANDUpdates properties of a guild-specific application command in the connected server. Omitted properties remain unchanged.

Input Parameters

string
New name for the command (1-32 characters).
array
New list of command option objects. If provided, all existing options are overwritten.
string
required
The unique identifier (snowflake ID) of the guild.
string
required
The unique identifier (snowflake ID) of the command to update.
string
New description for the command (1-100 characters).
boolean
Whether available in DMs. Not supported for guild commands; will be ignored.
string
required
The unique identifier (snowflake ID) of the Discord application.
object
Localization dictionary mapping locale codes to localized names.
object
Localization dictionary mapping locale codes to localized descriptions.
string
Bitwise permission flags string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_EMOJIUpdates 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 integration.

Input Parameters

string
The new name for the emoji (2-32 characters). If not provided, the name will not be changed.
array
A list of role IDs that are allowed to use this emoji. Provide an empty list to make the emoji available to @everyone.
string
required
The unique identifier of the custom emoji to be updated.
string
required
The unique identifier of the Discord guild (server) where the emoji resides.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_MEMBERUpdates a guild member’s nickname, roles, voice state, timeout timestamp, and flags, subject to appropriate permissions. Only non-null fields are sent, so null cannot clear a timeout or disconnect a member.

Input Parameters

boolean
Whether to server-deafen the member in voice channels. Requires DEAFEN_MEMBERS permission.
boolean
Whether to server-mute the member in voice channels. Requires MUTE_MEMBERS permission.
string
New nickname for the guild member. Set to empty string to remove. Maximum 32 characters.
integer
Guild member flags represented as a bit set integer.
array
Array of role IDs to assign to the member. Replaces all current roles except @everyone.
string
required
The unique identifier (snowflake ID) of the Discord user whose guild member attributes are being updated.
string
required
The unique identifier (snowflake ID) of the Discord guild where the member belongs.
string
Voice channel ID to move the member to. Set to null to disconnect from voice.
string
ISO8601 timestamp when the user’s timeout expires. Max 28 days from now. Set to null to remove timeout.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_ROLEUpdates a Discord guild role’s attributes (name, permissions, color, etc.). Requires MANAGE_ROLES permission. Unspecified attributes remain unchanged. The icon and unicode_emoji fields are mutually exclusive.

Input Parameters

string
New role icon as base64 encoded image data. Mutually exclusive with unicode_emoji.
string
New name for the role (max 100 characters).
integer
New color as an integer representation of a hex code (0 for no color).
boolean
Whether to display the role separately in the member list.
string
required
The unique identifier (snowflake ID) of the role to be updated.
string
required
The unique identifier (snowflake ID) of the guild containing the role.
boolean
Whether to allow anyone to mention this role.
string
Bitwise value for new role permissions.
string
New unicode emoji for the role’s icon. Mutually exclusive with icon. Requires ROLE_ICONS guild feature.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_SCHEDULED_EVENTUpdates an existing scheduled event in a Discord guild. Only fields provided in the request body are changed. Supports updating name, description, schedule, status, location, and other event attributes.

Input Parameters

string
The name of the scheduled event (1-100 characters).
string
The cover image as a base64 data URI.
integer
The event status: 1=SCHEDULED, 2=ACTIVE, 3=COMPLETED, 4=CANCELED. Cannot change from COMPLETED or CANCELED.
string
required
The unique identifier (snowflake ID) of the scheduled event to update.
string
required
The unique identifier (snowflake ID) of the Discord guild containing the event.
string
The channel ID where the event will be hosted. Required for STAGE_INSTANCE and VOICE. Set to null when changing to EXTERNAL.
string
The description of the scheduled event (1-1000 characters).
integer
The entity type: 1=STAGE_INSTANCE, 2=VOICE, 3=EXTERNAL.
integer
The privacy level of the event. Use 2 for GUILD_ONLY.
object
Additional metadata for the guild scheduled event.
string
The time the event will end (ISO8601 timestamp). Required for EXTERNAL entity type.
string
The time the event will start (ISO8601 timestamp).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_STICKERModifies a guild sticker’s name, description, or tags. Requires MANAGE_EXPRESSIONS permission.

Input Parameters

string
New name for the sticker (2-30 characters).
string
The Discord name of a unicode emoji representing the sticker’s expression (2-200 characters).
string
required
ID of the guild where the sticker is located.
string
required
ID of the sticker to be updated.
string
New description for the sticker (2-100 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_TEMPLATEUpdates a Discord guild template’s name and/or description; omitted fields retain current values, and an empty string for description clears it.

Input Parameters

string
New name for the guild template; if omitted, the current name is retained.
string
required
Unique identifier of the Discord guild where the template resides.
string
New description for the guild template; if omitted, the current description is retained. An empty string clears it.
string
required
Unique code of the guild template to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_WELCOME_SCREENUpdates a guild’s welcome screen configuration, including description, enabled status, and up to 5 welcome channels. Requires MANAGE_GUILD permission and the COMMUNITY feature.

Input Parameters

boolean
Whether the welcome screen is enabled.
string
required
The unique ID (snowflake) of the guild whose welcome screen is to be updated.
string
The server description to show in the welcome screen. Set to null to remove.
array
An array of welcome channel objects (max 5). Set to null or empty list to remove all.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_GUILD_WIDGET_SETTINGSUpdates a Discord guild’s widget settings, such as its enabled state or invite channel. Requires MANAGE_GUILD permission.

Input Parameters

boolean
Enables (true) or disables (false) the guild widget. Omit to leave unchanged.
string
required
Unique ID (snowflake) of the Discord guild whose widget settings are to be updated.
string
The channel ID to set as the widget’s invite channel, or null to clear it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_MESSAGEEdits a message previously sent by the bot. Only provide fields you want to change; use an empty string to clear content or an empty list to remove embeds, components, or attachments.

Input Parameters

integer
Message flags to set (e.g., 4 for SUPPRESS_EMBEDS).
array
Up to 10 embed objects. Set to empty list to remove all embeds.
string
New message content (max 2000 characters). Set to empty string to clear.
string
required
ID of the channel containing the message to edit.
array
Message components (buttons, select menus). Set to empty list to remove.
string
required
ID of the message to edit. Must be a message sent by the bot.
array
Attachments to keep or update metadata for. Omit to keep existing; empty list removes all.
object
Controls which mentions trigger notifications.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_MY_APPLICATIONDEPRECATED: This tool is no longer available. The bot’s profile and application settings are managed in the Discord Developer Portal. Updates settings for the current authenticated Discord application via /applications/@me.

Input Parameters

string
Base64 encoded application icon (PNG, JPEG, or GIF).
array
Up to 5 tags describing the application (max 20 chars each).
integer
Bitwise application flags value.
string
Base64 encoded cover image (PNG, JPEG, or GIF).
string
New description for the application.
integer
Max participants for an embedded activity.
string
Custom URL for post-authorization redirection.
string
HTTPS URL for Discord to send interaction events.
string
URL for role connection verification.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_MY_GUILD_MEMBERModifies the current bot’s member profile (nickname) in a Discord guild. The bot must be a member of the guild and have CHANGE_NICKNAME permission.

Input Parameters

string
The new nickname for the bot in the guild. Set to null or empty to remove. Maximum 32 characters.
string
required
The unique identifier (snowflake ID) of the Discord guild where the bot’s nickname will be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_MY_USERDEPRECATED: This tool is no longer available. The bot’s profile and application settings are managed in the Discord Developer Portal. Updates the current bot user’s Discord username and/or avatar. Only works with bot tokens. Username changes are rate-limited to 2 per hour.

Input Parameters

string
Base64 encoded image data for the new avatar (format: ‘data:image/png;base64,…’). Set to null to remove.
string
The new username for the bot user. Must be 2-32 characters. Changes are rate-limited to 2 per hour.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_ORIGINAL_WEBHOOK_MESSAGEUpdates the original (@original) message previously sent by a webhook or interaction response.

Input Parameters

integer
Message flags bitfield (e.g. 4 for SUPPRESS_EMBEDS).
array
Up to 10 embed objects; replaces existing embeds.
string
New message content (max 2000 characters). Null or empty string removes content.
string
ID of the thread the message is in, if applicable.
array
Message components (buttons, select menus); replaces existing.
string
required
The webhook or application ID.
array
Attachments to keep/update. Include existing attachment IDs to retain them.
string
required
The webhook or interaction token.
object
Controls which mentions in the message content trigger pings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_SELF_VOICE_STATEUpdates the bot’s own voice state in a guild Stage channel, such as toggling suppress or requesting to speak. The bot must already be connected to a stage channel via the Gateway API.

Input Parameters

string
required
The unique identifier (snowflake ID) of the Discord guild.
boolean
Whether to suppress (mute) the bot in the stage channel. True to suppress, false to unsuppress.
string
The ID of the stage channel. Required for stage channel operations.
string
ISO8601 timestamp for requesting to speak. Set to a timestamp to request, or null to clear the request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_VOICE_STATEUpdates another user’s voice state in a Discord stage channel. Only works for stage channels, not regular voice channels. Primarily used to toggle suppress state for speaking permissions. Requires MUTE_MEMBERS permission.

Input Parameters

string
required
The unique identifier (snowflake ID) of the user whose voice state to update.
string
required
The unique identifier (snowflake ID) of the Discord guild.
boolean
Whether to suppress (mute) the user in the stage channel. True to suppress, false to unsuppress. Requires MUTE_MEMBERS permission.
string
The ID of the stage channel where the user is participating. Required for stage channel operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_WEBHOOKUpdates properties of an existing Discord webhook such as name, avatar, or channel.

Input Parameters

string
New default name for the webhook.
string
Data URI for the new webhook avatar image. Set to null to remove the avatar.
string
ID of the new channel to move the webhook to.
string
required
The unique identifier of the webhook to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_WEBHOOK_BY_TOKENUpdates a Discord webhook’s name and/or avatar using its ID and token.

Input Parameters

string
New default name for the webhook (1-80 characters).
string
Data URI for the new webhook avatar image. Set to null to remove the avatar.
string
required
The unique identifier of the webhook to update.
string
required
The secure token of the webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DISCORDBOT_UPDATE_WEBHOOK_MESSAGEUpdates a message previously sent by a webhook, allowing modification of content, embeds, attachments, or components.

Input Parameters

integer
Message flags bitfield (e.g. 4 for SUPPRESS_EMBEDS).
array
Up to 10 embed objects; replaces existing embeds.
string
New message text (max 2000 characters). Empty string removes content.
string
ID of the thread the message is in, if applicable.
array
Message components (buttons, select menus); replaces existing.
string
required
The ID of the message to update.
string
required
The unique ID of the webhook.
array
Attachments to keep/update. Include existing attachment IDs to retain them.
string
required
The secret token for the webhook.
object
Controls which mentions in the message content trigger pings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not