# Discord Bot

Discordbot refers to automated programs on Discord servers, performing tasks like moderation, music playback, and user engagement to enhance community interactions

- **Category:** team chat
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 165
- **Triggers:** 0
- **Slug:** `DISCORDBOT`
- **Version:** 20260414_00

## Tools

### Add recipient to group channel

**Slug:** `DISCORDBOT_ADD_GROUP_DM_USER`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nick` | string | No | Nickname for the user in the group DM. |
| `user_id` | string | Yes | ID of the user to add to the group DM channel. |
| `channel_id` | string | Yes | ID of the group DM channel to add the user to. |
| `access_token` | string | No | Access token of the user being added; must have the gdm.join OAuth2 scope. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add guild member

**Slug:** `DISCORDBOT_ADD_GUILD_MEMBER`

Adds 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deaf` | boolean | No | Whether the user should be server deafened in voice channels. |
| `mute` | boolean | No | Whether the user should be server muted in voice channels. |
| `nick` | string | No | Nickname to set for the user in this guild. Maximum 32 characters. |
| `roles` | array | No | List of role IDs to assign to the user upon joining. |
| `user_id` | string | Yes | The unique identifier (snowflake ID) of the user to add. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild to add the user to. |
| `access_token` | string | Yes | OAuth2 access token for the user, with guilds.join scope, to authorize adding them to the guild. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Assign role to guild member

**Slug:** `DISCORDBOT_ADD_GUILD_MEMBER_ROLE`

Assigns a role to a guild member. Requires MANAGE_ROLES permission and the role must be lower in hierarchy than the bot's highest role. Returns 204 on success.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role_id` | string | Yes | The unique identifier (snowflake ID) of the Discord role to be assigned to the member. |
| `user_id` | string | Yes | The unique identifier (snowflake ID) of the Discord user to whom the role will be added. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild where the member and role exist. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Reaction To Message

**Slug:** `DISCORDBOT_ADD_MY_MESSAGE_REACTION`

Adds 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emoji` | string | Yes | Emoji to react with. For Unicode emojis use the character directly (e.g., '👍'). For custom emojis use 'name:id' format (e.g., 'myemoji:123456789012345678'). |
| `channel_id` | string | Yes | ID of the channel containing the message. |
| `message_id` | string | Yes | ID of the message to react to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add thread member

**Slug:** `DISCORDBOT_ADD_THREAD_MEMBER`

Adds a user to a specific, unarchived thread. The user must have access to the parent channel.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The ID of the user to add to the thread. |
| `channel_id` | string | Yes | The ID of the thread to add the user to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ban user from guild

**Slug:** `DISCORDBOT_BAN_USER_FROM_GUILD`

Permanently bans a user from a Discord guild, optionally deleting their recent messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The ID of the user to ban. |
| `guild_id` | string | Yes | The ID of the guild to ban the user from. |
| `delete_message_seconds` | integer | No | Number of seconds (0-604800) of the user's past messages to delete. Defaults to 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk ban users from guild

**Slug:** `DISCORDBOT_BULK_BAN_USERS_FROM_GUILD`

Bans up to 200 users from a Discord guild, optionally deleting their recent messages. Requires BAN_MEMBERS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The ID of the guild to ban users from. |
| `user_ids` | array | Yes | Array of user IDs to ban (maximum 200). |
| `delete_message_seconds` | integer | No | Number of seconds (0-604800) of messages to delete for banned users. Defaults to 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Delete Messages

**Slug:** `DISCORDBOT_BULK_DELETE_MESSAGES`

Bulk 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `messages` | array | Yes | List of message IDs to delete (2-100). All messages must be less than 14 days old. |
| `channel_id` | string | Yes | ID of the channel from which to bulk delete messages. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create global application command

**Slug:** `DISCORDBOT_CREATE_APPLICATION_COMMAND`

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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create auto moderation rule

**Slug:** `DISCORDBOT_CREATE_AUTO_MODERATION_RULE`

Creates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the rule (1-100 characters). |
| `actions` | array | Yes | The actions to execute when the rule is triggered (max 5). |
| `enabled` | boolean | No | Whether the rule is enabled. Defaults to false. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild where the rule will be created. |
| `event_type` | integer | Yes | The event type: 1=MESSAGE_SEND, 2=MEMBER_UPDATE. |
| `exempt_roles` | array | No | Role IDs not affected by the rule (max 20). |
| `trigger_type` | integer | Yes | 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). |
| `exempt_channels` | array | No | Channel IDs not affected by the rule (max 50). |
| `trigger_metadata` | object | No | Additional metadata associated with the rule's trigger type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create channel invite

**Slug:** `DISCORDBOT_CREATE_CHANNEL_INVITE`

Creates a new invite link for a Discord channel. Requires CREATE_INSTANT_INVITE permission.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Initiate user channel with recipient

**Slug:** `DISCORDBOT_CREATE_DM`

Creates a new direct message (DM) channel or retrieves an existing one, using recipient_id for a 1-on-1 DM or access_tokens for a group DM; this action only establishes or fetches the channel and does not send messages.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create new guild

**Slug:** `DISCORDBOT_CREATE_GUILD`

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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create guild application command

**Slug:** `DISCORDBOT_CREATE_GUILD_APPLICATION_COMMAND`

Creates a new guild-specific application command. Command names must be unique per type within the guild (max 100 total commands).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | 1-32 character command name. For CHAT_INPUT commands, must be lowercase. |
| `type` | integer | No | Command type: 1 (CHAT_INPUT, default), 2 (USER), 3 (MESSAGE). |
| `options` | array | No | Array of command option objects (max 25). |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild. |
| `description` | string | No | 1-100 character description for CHAT_INPUT commands. Empty string or omit for USER/MESSAGE. |
| `dm_permission` | boolean | No | Whether the command is available in DMs. Only for globally-scoped commands. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |
| `name_localizations` | object | No | Localization dictionary mapping locale codes to localized names. |
| `description_localizations` | object | No | Localization dictionary mapping locale codes to localized descriptions. |
| `default_member_permissions` | string | No | Bitwise permission flags string. '0' disables for non-admins. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create guild channel

**Slug:** `DISCORDBOT_CREATE_GUILD_CHANNEL`

Creates a new Discord channel (text, voice, category, etc.) within a guild. Requires MANAGE_CHANNELS permission.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create guild emoji

**Slug:** `DISCORDBOT_CREATE_GUILD_EMOJI`

Creates a new custom emoji in a specified Discord guild, requiring CREATE_EXPRESSIONS permission and adherence to guild emoji limits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name for the new emoji. Must be between 2 and 32 characters long and can only contain alphanumeric characters and underscores. |
| `image` | string | Yes | 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. |
| `roles` | array | No | An array of role IDs to which this emoji will be restricted. If omitted or empty, the emoji is available to @everyone. |
| `guild_id` | string | Yes | The ID of the Discord guild (server) where the emoji will be created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create guild from template

**Slug:** `DISCORDBOT_CREATE_GUILD_FROM_TEMPLATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon` | string | No | Data URI scheme (e.g., 'data:image/png;base64,...') for the guild's 128x128 icon. |
| `name` | string | Yes | Name for the new guild (2-100 characters). |
| `template_code` | string | Yes | The unique code of the guild template to use. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create role with guild id

**Slug:** `DISCORDBOT_CREATE_GUILD_ROLE`

Creates 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create guild scheduled event

**Slug:** `DISCORDBOT_CREATE_GUILD_SCHEDULED_EVENT`

Creates 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create guild sticker

**Slug:** `DISCORDBOT_CREATE_GUILD_STICKER`

Uploads 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create guild template

**Slug:** `DISCORDBOT_CREATE_GUILD_TEMPLATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the new guild template (1-100 characters). |
| `guild_id` | string | Yes | ID of the existing guild from which to create the template. |
| `description` | string | No | Optional description for the guild template (0-120 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Post interaction callback

**Slug:** `DISCORDBOT_CREATE_INTERACTION_RESPONSE`

Sends a response to a Discord interaction (e.g., slash command, component). Ensure response type is context-appropriate and initial reply is within 3 seconds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | No | Data payload for an interaction callback response. |
| `type` | integer | Yes | Type of response: 1 (Pong), 4 (ChannelMessageWithSource), 5 (DeferredChannelMessageWithSource), 6 (DeferredMessageUpdate), 7 (UpdateMessage), 8 (AutocompleteResult), 9 (Modal). |
| `interaction_id` | string | Yes | ID of the originating user interaction (e.g., slash command, button). |
| `interaction_token` | string | Yes | Temporary token for responding to the interaction, valid for 15 minutes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Message To Channel

**Slug:** `DISCORDBOT_CREATE_MESSAGE`

Sends 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tts` | boolean | No | Whether this is a text-to-speech message. |
| `flags` | integer | No | Message flags (e.g., 4 for SUPPRESS_EMBEDS, 64 for EPHEMERAL). |
| `embeds` | array | No | Up to 10 embed objects. Each embed can contain title, description, url, timestamp, color, footer, image, thumbnail, video, provider, author, and fields. |
| `content` | string | No | Message text content (max 2000 characters). Required if embeds, sticker_ids, and components are all empty. |
| `channel_id` | string | Yes | ID of the channel to send the message to. |
| `components` | array | No | Up to 5 action rows of interactive components (buttons, select menus). |
| `sticker_ids` | array | No | Up to 3 sticker IDs accessible to the bot. |
| `allowed_mentions` | object | No | 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). |
| `message_reference` | object | No | Reference for replying to a message. Requires message_id. Optional: channel_id, guild_id, fail_if_not_exists. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create stage instance

**Slug:** `DISCORDBOT_CREATE_STAGE_INSTANCE`

Creates 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create new thread in channel

**Slug:** `DISCORDBOT_CREATE_THREAD`

Creates a new thread in a text, announcement, forum, or media channel.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create thread from message

**Slug:** `DISCORDBOT_CREATE_THREAD_FROM_MESSAGE`

Creates a new thread from a specific message in a Discord channel, requiring CREATE_PUBLIC_THREADS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name for the new thread (1-100 characters). |
| `channel_id` | string | Yes | The ID of the channel containing the message to create a thread from. |
| `message_id` | string | Yes | The ID of the message to create the thread from. |
| `rate_limit_per_user` | integer | No | Seconds a user must wait before sending another message in the thread (0-21600). |
| `auto_archive_duration` | integer | No | Duration in minutes to automatically archive the thread after inactivity. Accepted values: 60, 1440, 4320, 10080. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create channel webhook

**Slug:** `DISCORDBOT_CREATE_WEBHOOK`

Creates a new webhook in a specified Discord channel, requiring MANAGE_WEBHOOKS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the webhook (1-80 characters). |
| `avatar` | string | No | Base64-encoded image data URI for the webhook avatar (e.g. 'data:image/png;base64,...'). |
| `channel_id` | string | Yes | The ID of the channel to create the webhook in. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Crosspost Message

**Slug:** `DISCORDBOT_CROSSPOST_MESSAGE`

Crossposts 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | ID of the announcement channel containing the message to crosspost. |
| `message_id` | string | Yes | ID of the message to crosspost to all following channels. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete All Reactions

**Slug:** `DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS`

Removes all reactions from a message. Requires MANAGE_MESSAGES permission. This removes reactions from all users, not just the bot.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | ID of the channel containing the message. |
| `message_id` | string | Yes | ID of the message to remove all reactions from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete All Reactions By Emoji

**Slug:** `DISCORDBOT_DELETE_ALL_MESSAGE_REACTIONS_BY_EMOJI`

Removes all reactions for a specific emoji from a message. Requires MANAGE_MESSAGES permission. Removes reactions from all users, not just the bot.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emoji` | string | Yes | Emoji to remove all reactions for. For Unicode emojis use the character directly (e.g., '👍'). For custom emojis use 'name:id' format. |
| `channel_id` | string | Yes | ID of the channel containing the message. |
| `message_id` | string | Yes | ID of the message to remove reactions from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete global application command

**Slug:** `DISCORDBOT_DELETE_APPLICATION_COMMAND`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command_id` | string | Yes | The unique identifier (snowflake ID) of the command to permanently delete. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application that owns the command. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete auto moderation rule

**Slug:** `DISCORDBOT_DELETE_AUTO_MODERATION_RULE`

Permanently deletes a specific auto moderation rule from a Discord guild. Requires MANAGE_GUILD permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule_id` | string | Yes | The unique identifier (snowflake ID) of the auto moderation rule to delete. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild containing the rule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete channel by id

**Slug:** `DISCORDBOT_DELETE_CHANNEL`

Permanently deletes a Discord channel by its ID. This action is irreversible. Returns the deleted channel object (not 204).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The unique identifier of the Discord channel to be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete channel permission override

**Slug:** `DISCORDBOT_DELETE_CHANNEL_PERMISSION_OVERWRITE`

Removes 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | ID of the Discord guild channel from which the permission overwrite will be removed. |
| `overwrite_id` | string | Yes | ID of the user or role whose permission overwrite will be deleted from the channel. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove user from group DM

**Slug:** `DISCORDBOT_DELETE_GROUP_DM_USER`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the user to be removed from the group DM channel. |
| `channel_id` | string | Yes | The unique identifier of the group DM channel from which the user will be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild by id

**Slug:** `DISCORDBOT_DELETE_GUILD`

Permanently deletes a specified Discord guild (server). The authenticated user must be the owner of the guild. This action is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild (server) to be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild application command

**Slug:** `DISCORDBOT_DELETE_GUILD_APPLICATION_COMMAND`

Permanently deletes a guild-specific application command. This is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild. |
| `command_id` | string | Yes | The unique identifier (snowflake ID) of the command to permanently delete. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild emoji by id

**Slug:** `DISCORDBOT_DELETE_GUILD_EMOJI`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emoji_id` | string | Yes | The unique identifier of the custom emoji to be deleted from the guild. |
| `guild_id` | string | Yes | The unique identifier of the Discord guild (server) from which the emoji will be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild integration

**Slug:** `DISCORDBOT_DELETE_GUILD_INTEGRATION`

Permanently deletes a specific integration from a Discord guild, removing any associated webhooks and kicking the bot if present. Requires MANAGE_GUILD permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild from which the integration will be deleted. |
| `integration_id` | string | Yes | The unique identifier of the integration to be deleted from the guild. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild member by id

**Slug:** `DISCORDBOT_DELETE_GUILD_MEMBER`

Removes (kicks) a member from a Discord guild. The user must be an existing member of the specified guild. Requires KICK_MEMBERS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier (snowflake ID) of the user to be removed from the guild. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild from which the member will be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild member role

**Slug:** `DISCORDBOT_DELETE_GUILD_MEMBER_ROLE`

Removes 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role_id` | string | Yes | The unique identifier (snowflake ID) of the role to be removed from the guild member. |
| `user_id` | string | Yes | The unique identifier (snowflake ID) of the user whose role is to be removed. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild from which the member's role will be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete role from guild

**Slug:** `DISCORDBOT_DELETE_GUILD_ROLE`

Permanently deletes a specified role from a Discord guild, revoking it from all members. Requires MANAGE_ROLES permission and the target role must be lower in hierarchy than the bot's highest role.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role_id` | string | Yes | The unique identifier (snowflake ID) of the role to be deleted. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild from which the role will be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild scheduled event

**Slug:** `DISCORDBOT_DELETE_GUILD_SCHEDULED_EVENT`

Permanently deletes a specific scheduled event from a Discord guild. This action is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | The unique identifier (snowflake ID) of the scheduled event to delete. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild containing the event. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild sticker

**Slug:** `DISCORDBOT_DELETE_GUILD_STICKER`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild from which the sticker will be deleted. |
| `sticker_id` | string | Yes | The unique identifier of the sticker to be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete guild template by code

**Slug:** `DISCORDBOT_DELETE_GUILD_TEMPLATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The ID of the guild from which the template will be deleted. |
| `template_code` | string | Yes | The unique code of the guild template to be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Message

**Slug:** `DISCORDBOT_DELETE_MESSAGE`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | ID of the channel containing the message to delete. |
| `message_id` | string | Yes | ID of the message to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove My Reaction

**Slug:** `DISCORDBOT_DELETE_MY_MESSAGE_REACTION`

Removes the bot's own emoji reaction from a message. Only removes the bot's reaction, not other users' reactions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emoji` | string | Yes | Emoji to remove. For Unicode emojis use the character directly (e.g., '👍'). For custom emojis use 'name:id' format (e.g., 'myemoji:123456789012345678'). |
| `channel_id` | string | Yes | ID of the channel containing the message. |
| `message_id` | string | Yes | ID of the message to remove the reaction from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete original webhook message

**Slug:** `DISCORDBOT_DELETE_ORIGINAL_WEBHOOK_MESSAGE`

Permanently deletes the original (@original) message posted by a webhook or interaction response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `thread_id` | string | No | ID of the thread where the original message is located, if applicable. |
| `webhook_id` | string | Yes | The webhook or application ID. |
| `webhook_token` | string | Yes | The webhook or interaction token. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete stage instance

**Slug:** `DISCORDBOT_DELETE_STAGE_INSTANCE`

Permanently deletes the Stage instance for a given stage channel, ending the live audio event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The unique identifier (snowflake ID) of the stage channel whose Stage instance is to be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove thread member

**Slug:** `DISCORDBOT_DELETE_THREAD_MEMBER`

Removes a user from a specified, unarchived thread. Requires MANAGE_THREADS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The ID of the user to remove from the thread. |
| `channel_id` | string | Yes | The ID of the thread from which the user will be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove User Reaction

**Slug:** `DISCORDBOT_DELETE_USER_MESSAGE_REACTION`

Removes a specific user's emoji reaction from a message. Requires MANAGE_MESSAGES permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emoji` | string | Yes | Emoji to remove. For Unicode emojis use the character directly (e.g., '👍'). For custom emojis use 'name:id' format. |
| `user_id` | string | Yes | ID of the user whose reaction to remove. |
| `channel_id` | string | Yes | ID of the channel containing the message. |
| `message_id` | string | Yes | ID of the message to remove the reaction from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete webhook by id

**Slug:** `DISCORDBOT_DELETE_WEBHOOK`

Permanently deletes a Discord webhook by its unique ID. This action is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | The unique identifier of the webhook to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete webhook by token

**Slug:** `DISCORDBOT_DELETE_WEBHOOK_BY_TOKEN`

Permanently deletes a Discord webhook using its ID and token, without bot authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | The unique identifier of the webhook to delete. |
| `webhook_token` | string | Yes | The secret token of the webhook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete webhook message

**Slug:** `DISCORDBOT_DELETE_WEBHOOK_MESSAGE`

Deletes a message previously sent by a Discord webhook.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `thread_id` | string | No | ID of the thread the message is in, if applicable. |
| `message_id` | string | Yes | The ID of the message to delete. |
| `webhook_id` | string | Yes | The unique ID of the webhook. |
| `webhook_token` | string | Yes | The secret token for the webhook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute GitHub-compatible webhook

**Slug:** `DISCORDBOT_EXECUTE_GITHUB_COMPATIBLE_WEBHOOK`

Forwards GitHub event notifications to a Discord channel via a GitHub-compatible webhook endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ref` | string | No | Git reference involved in the event (e.g. 'refs/heads/main'). |
| `wait` | boolean | No | If true, waits for message confirmation before responding. |
| `issue` | object | No | GitHub issue object for issue-related events. |
| `action` | string | No | Type of action that triggered the GitHub event (e.g. 'opened', 'created'). |
| `answer` | object | No | Answer object for GitHub Discussions answer events. |
| `forced` | boolean | No | Whether the push was a force push. |
| `forkee` | object | No | New repository object created in fork events. |
| `member` | object | No | GitHub member/user object for member-related events. |
| `review` | object | No | GitHub pull request review object for review events. |
| `sender` | object | No | GitHub user/application that triggered the event. |
| `comment` | object | No | GitHub comment object for comment-related events. |
| `commits` | array | No | List of commit details for push events. |
| `compare` | string | No | URL to view the comparison of changes. |
| `release` | object | No | GitHub release object for release events. |
| `ref_type` | string | No | Type of the Git reference (e.g. 'branch', 'tag'). |
| `check_run` | object | No | GitHub Check Run object for CI/CD events. |
| `thread_id` | string | No | ID of a target Discord thread for the message. |
| `discussion` | object | No | GitHub Discussion object for discussion events. |
| `repository` | object | No | GitHub repository object containing repo metadata. |
| `webhook_id` | string | Yes | The unique identifier of the Discord webhook. |
| `check_suite` | object | No | GitHub Check Suite object for grouped check runs. |
| `head_commit` | object | No | Most recent commit object in push events. |
| `pull_request` | object | No | GitHub pull request object for PR-related events. |
| `webhook_token` | string | Yes | The secret token for the Discord webhook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute Slack-compatible webhook

**Slug:** `DISCORDBOT_EXECUTE_SLACK_COMPATIBLE_WEBHOOK`

Sends messages to Discord via its Slack-compatible webhook endpoint, supporting Slack attachment formatting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | No | The main message content (max 2000 characters). Supports Slack mrkdwn formatting. |
| `wait` | boolean | No | If true, waits for server confirmation before responding. |
| `icon_url` | string | No | URL for the avatar icon, overriding the default webhook icon. |
| `username` | string | No | Override the default webhook username (max 80 characters). |
| `thread_id` | string | No | ID of a target thread within the channel to send the message to. |
| `webhook_id` | string | Yes | The unique identifier of the Discord webhook. |
| `attachments` | array | No | Up to 10 Slack-style attachment objects for rich formatting. |
| `webhook_token` | string | Yes | The secret token for the Discord webhook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute webhook

**Slug:** `DISCORDBOT_EXECUTE_WEBHOOK`

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

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add follower to channel via webhook

**Slug:** `DISCORDBOT_FOLLOW_CHANNEL`

Follows an Announcement Channel to relay its messages to a target channel via webhook. The bot must have MANAGE_WEBHOOKS permission in the target channel.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The ID of the Announcement Channel (type 5) to follow. This is the source channel whose messages will be relayed. |
| `webhook_channel_id` | string | Yes | The ID of the target channel where messages from the followed Announcement Channel will be posted. Requires MANAGE_WEBHOOKS permission. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List active threads in guild

**Slug:** `DISCORDBOT_GET_ACTIVE_GUILD_THREADS`

Retrieves all active (non-archived) threads in a Discord guild that the bot can access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The ID of the guild to retrieve active threads from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get application details

**Slug:** `DISCORDBOT_GET_APPLICATION`

Retrieves the full details of a Discord application by its application_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get global application command

**Slug:** `DISCORDBOT_GET_APPLICATION_COMMAND`

Retrieves a specific global application command by its application ID and command ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command_id` | string | Yes | The unique identifier (snowflake ID) of the command to retrieve. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get application role connections metadata

**Slug:** `DISCORDBOT_GET_APPLICATION_ROLE_CONNECTIONS_METADATA`

Retrieves all role connection metadata records for a Discord application. Returns an empty list if none are configured.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get user role connection

**Slug:** `DISCORDBOT_GET_APPLICATION_USER_ROLE_CONNECTION`

Fetches the role connection object for the current user for a specified Discord application. Requires OAuth2 with the role_connections.write scope.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `application_id` | string | Yes | The unique ID of the Discord application for which the user's role connection information is being requested. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get auto moderation rule

**Slug:** `DISCORDBOT_GET_AUTO_MODERATION_RULE`

Retrieves the complete configuration of a specific auto moderation rule within a Discord guild.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule_id` | string | Yes | The unique identifier (snowflake ID) of the auto moderation rule to retrieve. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get bot gateway

**Slug:** `DISCORDBOT_GET_BOT_GATEWAY`

Retrieves the WSS URL, recommended shard count, and session start limits for connecting a bot to the Discord Gateway.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve channel details

**Slug:** `DISCORDBOT_GET_CHANNEL`

Retrieves detailed metadata for a specific Discord channel by its channel_id. Returns only channel metadata, not message content or member lists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The ID of the Discord channel to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get gateway URL

**Slug:** `DISCORDBOT_GET_GATEWAY`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild details

**Slug:** `DISCORDBOT_GET_GUILD`

Retrieves detailed information for a specified Discord guild (server) by its guild_id, optionally including approximate member and presence counts if with_counts is true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) to retrieve. |
| `with_counts` | boolean | No | When true, includes approximate member and presence counts for the guild. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild application command

**Slug:** `DISCORDBOT_GET_GUILD_APPLICATION_COMMAND`

Retrieves detailed information for a specific application command within a Discord guild.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild. |
| `command_id` | string | Yes | The unique identifier (snowflake ID) of the command to retrieve. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild command permissions

**Slug:** `DISCORDBOT_GET_GUILD_APPLICATION_COMMAND_PERMISSIONS`

Retrieves the permissions for a specific application command within a guild.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild. |
| `command_id` | string | Yes | The unique identifier (snowflake ID) of the command. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild ban

**Slug:** `DISCORDBOT_GET_GUILD_BAN`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The ID of the user to retrieve ban details for. |
| `guild_id` | string | Yes | The ID of the guild. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fetch emoji by guild and id

**Slug:** `DISCORDBOT_GET_GUILD_EMOJI`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emoji_id` | string | Yes | The unique identifier of the custom emoji to retrieve. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) from which to fetch the emoji. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild member by user id

**Slug:** `DISCORDBOT_GET_GUILD_MEMBER`

Retrieves detailed information for a specific member of a Discord guild, provided the bot belongs to the guild and has necessary permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier (snowflake ID) of the Discord user whose guild member information is to be retrieved. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) from which to fetch the member. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview guild by id

**Slug:** `DISCORDBOT_GET_GUILD_PREVIEW`

Fetches a public preview of a Discord guild by its ID, if the guild has the preview feature enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild (server) to preview. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild scheduled event

**Slug:** `DISCORDBOT_GET_GUILD_SCHEDULED_EVENT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | The unique identifier (snowflake ID) of the scheduled event to retrieve. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild containing the event. |
| `with_user_count` | boolean | No | When true, includes the count of users subscribed to the event in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild onboarding

**Slug:** `DISCORDBOT_GET_GUILDS_ONBOARDING`

Retrieves the onboarding settings for a specified Discord guild, including prompts, options, default channels, and enabled status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild for which to retrieve onboarding information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve sticker from guild

**Slug:** `DISCORDBOT_GET_GUILD_STICKER`

Retrieves a specific sticker from a Discord guild using the guild and sticker IDs; requires the sticker to exist in the guild.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The snowflake ID of the Discord guild (server) from which to retrieve the sticker. |
| `sticker_id` | string | Yes | The snowflake ID of the sticker to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild template with code

**Slug:** `DISCORDBOT_GET_GUILD_TEMPLATE`

Retrieves the complete structure and details of a Discord guild template using its unique code.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_code` | string | Yes | The unique code of the guild template. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild vanity url

**Slug:** `DISCORDBOT_GET_GUILD_VANITY_URL`

Retrieves the vanity URL invite code and usage count for a Discord guild. Requires MANAGE_GUILD permission and the VANITY_URL feature.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild for which to retrieve the vanity URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild webhooks

**Slug:** `DISCORDBOT_GET_GUILD_WEBHOOKS`

Retrieves all webhooks for a specified Discord guild, requiring MANAGE_WEBHOOKS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild for which to retrieve webhooks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild welcome screen

**Slug:** `DISCORDBOT_GET_GUILD_WELCOME_SCREEN`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique snowflake ID of the Discord guild to retrieve the welcome screen for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild widget json

**Slug:** `DISCORDBOT_GET_GUILD_WIDGET`

Retrieves the public JSON widget data for a Discord guild, if the widget is enabled for that guild.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild for which to retrieve the widget JSON. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Guild Widget PNG

**Slug:** `DISCORDBOT_GET_GUILD_WIDGET_PNG`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `style` | string ("shield" | "banner1" | "banner2" | "banner3" | "banner4") | No | Customizes the visual appearance of the widget image. Options: 'shield' (compact badge-style), 'banner1', 'banner2', 'banner3', 'banner4' (various horizontal banner formats). |
| `guild_id` | string | Yes | The unique identifier of the guild (snowflake ID). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild widget settings

**Slug:** `DISCORDBOT_GET_GUILD_WIDGET_SETTINGS`

Retrieves the widget settings for a specified Discord guild, indicating if the widget is enabled and its configured channel ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild for which to retrieve widget settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Message

**Slug:** `DISCORDBOT_GET_MESSAGE`

Retrieves a specific message from a Discord channel by channel and message ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The ID of the Discord channel containing the message. |
| `message_id` | string | Yes | The ID of the message to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get my application

**Slug:** `DISCORDBOT_GET_MY_APPLICATION`

Retrieves detailed information about the current authenticated Discord application via /applications/@me.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get my OAuth2 application

**Slug:** `DISCORDBOT_GET_MY_OAUTH2_APPLICATION`

Retrieves detailed information about the OAuth2 application associated with the current authentication.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve original webhook message

**Slug:** `DISCORDBOT_GET_ORIGINAL_WEBHOOK_MESSAGE`

Retrieves the original (@original) message from a Discord webhook or interaction response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `thread_id` | string | No | ID of the thread where the original message was posted, if applicable. |
| `webhook_id` | string | Yes | The webhook or application ID. For interaction responses, this is the bot's application ID. |
| `webhook_token` | string | Yes | The webhook or interaction token. For interactions, valid for 15 minutes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OAuth2 public keys

**Slug:** `DISCORDBOT_GET_PUBLIC_KEYS`

Retrieves Discord's OAuth2 public keys in JWK format for verifying access tokens. Keys may rotate, so refresh caches periodically.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get stage instance

**Slug:** `DISCORDBOT_GET_STAGE_INSTANCE`

Retrieves the active Stage instance for a specified stage channel. Returns 404 if no active Stage instance exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The unique identifier (snowflake ID) of the stage channel whose active Stage instance is to be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get sticker

**Slug:** `DISCORDBOT_GET_STICKER`

Retrieves a specific Discord sticker by its unique ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sticker_id` | string | Yes | The unique identifier (snowflake ID) of the sticker to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve thread member by id

**Slug:** `DISCORDBOT_GET_THREAD_MEMBER`

Retrieves a member from a specified thread using their user ID, optionally including guild member details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The ID of the user whose membership in the thread is being retrieved. |
| `channel_id` | string | Yes | The ID of the thread. |
| `with_member` | boolean | No | If true, includes the full guild member object in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get user

**Slug:** `DISCORDBOT_GET_USER`

Fetches public information for a Discord user by their user ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier (snowflake ID) of the Discord user to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve webhook by id

**Slug:** `DISCORDBOT_GET_WEBHOOK`

Retrieves detailed information for a Discord webhook by its unique ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | The unique identifier of the Discord webhook to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve webhook by token

**Slug:** `DISCORDBOT_GET_WEBHOOK_BY_TOKEN`

Retrieves a Discord webhook's configuration using its ID and token, without requiring bot authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | The unique identifier of the Discord webhook. |
| `webhook_token` | string | Yes | The secret token for the Discord webhook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve webhook message

**Slug:** `DISCORDBOT_GET_WEBHOOK_MESSAGE`

Retrieves a specific message previously sent by a Discord webhook.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `thread_id` | string | No | ID of the thread if the message is part of one. |
| `message_id` | string | Yes | The unique ID of the message to retrieve. |
| `webhook_id` | string | Yes | The unique ID of the webhook that sent the message. |
| `webhook_token` | string | Yes | The secret token for the webhook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve invite by code

**Slug:** `DISCORDBOT_INVITE_RESOLVE`

Resolves a Discord invite code to get its details, optionally including member counts and expiration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invite_code` | string | Yes | The unique invite code (e.g. 'nYUs4yAE' from 'discord.gg/nYUs4yAE'). |
| `with_counts` | boolean | No | If true, include approximate member and presence counts. |
| `with_expiration` | boolean | No | If true, include the expiration date of the invite. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Revoke invite by code

**Slug:** `DISCORDBOT_INVITE_REVOKE`

Revokes a Discord invite using its code, permanently preventing new joins via this link.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invite_code` | string | Yes | The unique code of the Discord invite to revoke. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Join thread

**Slug:** `DISCORDBOT_JOIN_THREAD`

Joins the authenticated user to a thread specified by channel_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The ID of the thread to join. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Leave Guild

**Slug:** `DISCORDBOT_LEAVE_GUILD`

Enables the bot to leave a specified Discord guild (server). This action is irreversible and the bot must be re-invited to rejoin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild (server) the bot wishes to leave. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Leave thread

**Slug:** `DISCORDBOT_LEAVE_THREAD`

Removes the currently authenticated user from a specified thread.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The ID of the thread to leave. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List global application commands

**Slug:** `DISCORDBOT_LIST_APPLICATION_COMMANDS`

Fetches all global application commands for the specified Discord application. Does not include guild-specific commands.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |
| `with_localizations` | boolean | No | Whether to include full localization dictionaries in the returned command objects. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List auto moderation rules

**Slug:** `DISCORDBOT_LIST_AUTO_MODERATION_RULES`

Retrieves all auto moderation rules for a specified Discord guild. Requires MANAGE_GUILD permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild whose auto moderation rules to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List channel invites

**Slug:** `DISCORDBOT_LIST_CHANNEL_INVITES`

Fetches all active invites for a given Discord channel. Requires MANAGE_CHANNELS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The ID of the channel to retrieve invites for. Requires MANAGE_CHANNELS permission. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Channel Webhooks

**Slug:** `DISCORDBOT_LIST_CHANNEL_WEBHOOKS`

Retrieves all webhooks configured in a given Discord channel. Requires the MANAGE_WEBHOOKS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The unique identifier of the Discord channel to list webhooks for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild command permissions

**Slug:** `DISCORDBOT_LIST_GUILD_APPLICATION_COMMAND_PERMISSIONS`

Retrieves all guild-level permission settings for all commands of a specific application within a guild.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild application commands

**Slug:** `DISCORDBOT_LIST_GUILD_APPLICATION_COMMANDS`

Fetches all application commands registered for a specific guild. Does not include global commands.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild to list commands for. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |
| `with_localizations` | boolean | No | Whether to include full localization dictionaries in the returned command objects. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild audit logs

**Slug:** `DISCORDBOT_LIST_GUILD_AUDIT_LOG_ENTRIES`

Retrieves audit log entries for a specified Discord guild, requiring VIEW_AUDIT_LOG permission. Supports filtering by user, action type, and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Retrieve audit log entries after this entry ID for pagination. |
| `limit` | integer | No | Maximum number of audit log entries to return (1-100). Defaults to 50. |
| `before` | string | No | Retrieve audit log entries before this entry ID for pagination. |
| `user_id` | string | No | Filter logs by the ID of the user who performed the action. |
| `guild_id` | string | Yes | ID of the Discord guild for which to retrieve audit logs. |
| `action_type` | integer | No | Filter logs by a specific audit log event type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild bans

**Slug:** `DISCORDBOT_LIST_GUILD_BANS`

Fetches a list of users banned from a specified Discord guild. Requires BAN_MEMBERS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Fetch bans for users with IDs after this user ID. For forward pagination. |
| `limit` | integer | No | Maximum number of bans to return (1-1000). |
| `before` | string | No | Fetch bans for users with IDs before this user ID. For backward pagination. |
| `guild_id` | string | Yes | The ID of the guild to retrieve bans from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild channels

**Slug:** `DISCORDBOT_LIST_GUILD_CHANNELS`

Fetches all channels (text, voice, category, etc.) for a specified Discord guild. Does not include threads or message content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | Identifier of the Discord guild (server) whose channels to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild emojis

**Slug:** `DISCORDBOT_LIST_GUILD_EMOJIS`

Fetches all custom emoji objects for a specified Discord guild if the bot has access; returns only custom guild emojis, not standard Unicode or Nitro emojis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) for which to list emojis. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild integrations

**Slug:** `DISCORDBOT_LIST_GUILD_INTEGRATIONS`

Lists all integration objects for a specified Discord guild. Requires MANAGE_GUILD permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild for which to list integrations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild invites

**Slug:** `DISCORDBOT_LIST_GUILD_INVITES`

Retrieves all currently active invite codes for a specified Discord guild.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The ID of the guild to retrieve active invites from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild members

**Slug:** `DISCORDBOT_LIST_GUILD_MEMBERS`

Retrieves a list of members for a Discord guild. Requires GUILD_MEMBERS intent. Supports pagination via limit and after parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | User ID for pagination offset; fetches members with IDs greater than this value. |
| `limit` | integer | No | Max number of members to return (1-1000). Defaults to 1 if not specified. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) to retrieve members from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild roles

**Slug:** `DISCORDBOT_LIST_GUILD_ROLES`

Fetches all roles in a Discord guild, providing details for each role including permissions, color, position, and other attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) to retrieve roles from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild scheduled events

**Slug:** `DISCORDBOT_LIST_GUILD_SCHEDULED_EVENTS`

Retrieves a list of scheduled events for a specified Discord guild, optionally including subscribed user counts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild whose scheduled events to list. |
| `with_user_count` | boolean | No | When true, includes the count of users subscribed to each scheduled event. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List scheduled event users

**Slug:** `DISCORDBOT_LIST_GUILD_SCHEDULED_EVENT_USERS`

Fetches users who have expressed interest in a specific scheduled event within a Discord guild. Supports pagination and optional guild member data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Return users after this user ID for pagination. |
| `limit` | integer | No | Maximum number of users to return (1-100). Defaults to 100 if not specified. |
| `before` | string | No | Return users before this user ID for pagination. |
| `event_id` | string | Yes | The unique identifier (snowflake ID) of the scheduled event. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild. |
| `with_member` | boolean | No | When true, includes the guild member object for each user in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve guild stickers

**Slug:** `DISCORDBOT_LIST_GUILD_STICKERS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) for which to list stickers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get guild templates by guild id

**Slug:** `DISCORDBOT_LIST_GUILD_TEMPLATES`

Retrieves all guild templates for an existing Discord guild, specified by its ID. Requires MANAGE_GUILD permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild for which to retrieve templates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List guild voice regions

**Slug:** `DISCORDBOT_LIST_GUILD_VOICE_REGIONS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild (server). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reactions By Emoji

**Slug:** `DISCORDBOT_LIST_MESSAGE_REACTIONS_BY_EMOJI`

Lists users who reacted to a message with a specific emoji. Supports pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Get users after this user ID, for pagination. |
| `emoji` | string | Yes | Emoji to get reactions for. For Unicode emojis use the character directly (e.g., '👍'). For custom emojis use 'name:id' format. |
| `limit` | integer | No | Max number of users to return (1-100, defaults to 25). |
| `channel_id` | string | Yes | ID of the channel containing the message. |
| `message_id` | string | Yes | ID of the message to retrieve reactions from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fetch Messages From Channel

**Slug:** `DISCORDBOT_LIST_MESSAGES`

Retrieves messages from a Discord channel, ordered newest first. Supports pagination via before/after/around parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Get messages after this message ID for forward pagination. |
| `limit` | integer | No | Max number of messages to return (1-100, defaults to 50). |
| `around` | string | No | Get messages around this message ID. |
| `before` | string | No | Get messages before this message ID for backward pagination. |
| `channel_id` | string | Yes | ID of the Discord channel to fetch messages from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List my private archived threads

**Slug:** `DISCORDBOT_LIST_MY_PRIVATE_ARCHIVED_THREADS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of threads to return (1-100). |
| `before` | string | No | ISO8601 timestamp or thread ID. Returns threads archived before this value. |
| `channel_id` | string | Yes | The ID of the channel to retrieve private archived threads from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pinned Messages

**Slug:** `DISCORDBOT_LIST_PINNED_MESSAGES`

Retrieves all pinned messages from a Discord channel. Returns up to 50 pinned messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | ID of the Discord channel to retrieve pinned messages from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List private archived threads

**Slug:** `DISCORDBOT_LIST_PRIVATE_ARCHIVED_THREADS`

Lists private archived threads in a Discord channel, sorted by most recent archival. Requires view access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of threads to return (1-100). |
| `before` | string | No | ISO8601 timestamp or thread ID. Returns threads archived before this value. |
| `channel_id` | string | Yes | The ID of the channel to retrieve private archived threads from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List public archived threads

**Slug:** `DISCORDBOT_LIST_PUBLIC_ARCHIVED_THREADS`

Lists public archived threads in a Discord channel, sorted by most recent archival.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of threads to return (1-100). |
| `before` | string | No | ISO8601 timestamp or thread ID. Returns threads archived before this value. |
| `channel_id` | string | Yes | The ID of the channel to retrieve public archived threads from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List sticker packs

**Slug:** `DISCORDBOT_LIST_STICKER_PACKS`

Fetches all available Nitro sticker packs from Discord, excluding custom or guild-specific sticker packs.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List thread members

**Slug:** `DISCORDBOT_LIST_THREAD_MEMBERS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | User ID to paginate from, returning members after this ID. |
| `limit` | integer | No | Maximum number of thread members to return (1-100). |
| `channel_id` | string | Yes | The ID of the thread to retrieve members from. |
| `with_member` | boolean | No | If true, includes the full guild member object for each thread member. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List voice regions

**Slug:** `DISCORDBOT_LIST_VOICE_REGIONS`

Lists all available Discord voice regions that can be used when setting a voice or stage channel's region.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Pin Message

**Slug:** `DISCORDBOT_PIN_MESSAGE`

Pins a message in a Discord channel. Requires MANAGE_MESSAGES permission. A channel can have at most 50 pinned messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | ID of the channel containing the message to pin. |
| `message_id` | string | Yes | ID of the message to pin. Channel cannot exceed 50 pinned messages. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview guild prune

**Slug:** `DISCORDBOT_PREVIEW_PRUNE_GUILD`

Previews 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Prune inactive guild members

**Slug:** `DISCORDBOT_PRUNE_GUILD`

Removes inactive members from a Discord guild. Requires KICK_MEMBERS permission. Set compute_prune_count=false for large guilds to avoid timeouts.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild onboarding configuration

**Slug:** `DISCORDBOT_PUT_GUILDS_ONBOARDING`

Configures or updates a Discord guild's new member onboarding flow, including prompts, options, default channels, and enabled status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | integer | No | Onboarding mode (0 = ONBOARDING_DEFAULT, 1 = ONBOARDING_ADVANCED). |
| `enabled` | boolean | No | If true, the guild's onboarding flow is active. |
| `prompts` | array | No | Up to 5 onboarding prompts for the guild. |
| `guild_id` | string | Yes | Guild's unique ID (snowflake) for which onboarding settings are being updated. |
| `default_channel_ids` | array | No | Up to 7 channel IDs new members join post-onboarding. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search guild members by username or nickname

**Slug:** `DISCORDBOT_SEARCH_GUILD_MEMBERS`

Searches for members in a specific Discord guild by matching a query string against usernames and nicknames. Returns matching guild member objects.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of members to return (1-1000). Defaults to 1 if not specified. |
| `query` | string | Yes | The query string to match against usernames or nicknames. The search is prefix-based (e.g., 'adm' will match 'admin'). |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild (server) to search within. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Modify channel permissions

**Slug:** `DISCORDBOT_SET_CHANNEL_PERMISSION_OVERWRITE`

Updates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deny` | string | No | Bitwise value of Discord permission flags to deny as a string. '0' means no explicit denials. |
| `type` | integer | Yes | Type of entity overwrite_id refers to: 0 for a role or 1 for a member (user). |
| `allow` | string | No | Bitwise value of Discord permission flags to grant as a string. '0' means no new permissions. |
| `channel_id` | string | Yes | The unique identifier of the Discord channel where the permission overwrite will be applied. |
| `overwrite_id` | string | Yes | The unique identifier of the role or member (user) to whom the permission overwrite applies. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Sync guild template

**Slug:** `DISCORDBOT_SYNC_GUILD_TEMPLATE`

Synchronizes 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier of the Discord guild that is the source of the template. |
| `template_code` | string | Yes | The unique code of the guild template to be synchronized. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test bot token authentication

**Slug:** `DISCORDBOT_TEST_AUTH`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trigger typing indicator

**Slug:** `DISCORDBOT_TRIGGER_TYPING_INDICATOR`

Shows 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | The unique identifier of the Discord channel where the typing indicator should be displayed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unban user from guild

**Slug:** `DISCORDBOT_UNBAN_USER_FROM_GUILD`

Revokes a ban for a user from a Discord guild, allowing them to rejoin. Requires BAN_MEMBERS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The ID of the user to unban. |
| `guild_id` | string | Yes | The ID of the guild to remove the ban from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unpin Message

**Slug:** `DISCORDBOT_UNPIN_MESSAGE`

Unpins a message from a Discord channel. The message is not deleted, only removed from the pinned list. Requires MANAGE_MESSAGES permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | string | Yes | ID of the channel containing the pinned message. |
| `message_id` | string | Yes | ID of the message to unpin. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update application

**Slug:** `DISCORDBOT_UPDATE_APPLICATION`

Updates a Discord application's settings using its application_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon` | string | No | Base64 encoded application icon (PNG, JPEG, or GIF). |
| `tags` | array | No | Up to 5 tags describing the application (max 20 chars each). |
| `flags` | integer | No | Bitwise application flags value. |
| `cover_image` | string | No | Base64 encoded cover image (PNG, JPEG, or GIF). |
| `description` | string | No | New description for the application. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application to update. |
| `max_participants` | integer | No | Max participants for an embedded activity. |
| `custom_install_url` | string | No | Custom URL for post-authorization redirection. |
| `interactions_endpoint_url` | string | No | HTTPS URL for Discord to send interaction events. |
| `role_connections_verification_url` | string | No | URL for role connection verification. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update global application command

**Slug:** `DISCORDBOT_UPDATE_APPLICATION_COMMAND`

Updates properties of a global application command. Omitted properties remain unchanged. The options field, if provided, overwrites all existing options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the command (1-32 characters). |
| `options` | array | No | New list of command option objects. If provided, all existing options are overwritten. |
| `command_id` | string | Yes | The unique identifier (snowflake ID) of the command to update. |
| `description` | string | No | New description for the command (1-100 characters). Empty string for USER/MESSAGE commands. |
| `dm_permission` | boolean | No | Whether the command is available in DMs with the app. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |
| `name_localizations` | object | No | Localization dictionary mapping locale codes to localized names. |
| `description_localizations` | object | No | Localization dictionary mapping locale codes to localized descriptions. |
| `default_member_permissions` | string | No | Bitwise permission flags string. '0' disables for non-admins. Null allows everyone. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update user application role connection

**Slug:** `DISCORDBOT_UPDATE_APPLICATION_USER_ROLE_CONNECTION`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `metadata` | object | No | 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. |
| `platform_name` | string | No | The vanity name of the platform to display in Discord's user profile (max 50 characters). |
| `application_id` | string | Yes | The unique Discord application ID (snowflake). Must have linked role connection metadata configured. |
| `platform_username` | string | No | The user's username on the external platform (max 100 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update auto moderation rule

**Slug:** `DISCORDBOT_UPDATE_AUTO_MODERATION_RULE`

Updates an existing auto moderation rule in a Discord guild. Only fields provided in the request body are changed. Requires MANAGE_GUILD permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | The name of the rule (1-100 characters). |
| `actions` | array | No | The actions to execute when the rule is triggered (max 5). |
| `enabled` | boolean | No | Whether the rule is enabled. |
| `rule_id` | string | Yes | The unique identifier (snowflake ID) of the auto moderation rule to update. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild containing the rule. |
| `event_type` | integer | No | The event type: 1=MESSAGE_SEND, 2=MEMBER_UPDATE. |
| `exempt_roles` | array | No | Role IDs not affected by the rule (max 20). |
| `exempt_channels` | array | No | Channel IDs not affected by the rule (max 50). |
| `trigger_metadata` | object | No | Additional metadata associated with the rule's trigger type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update channel settings

**Slug:** `DISCORDBOT_UPDATE_CHANNEL`

Updates 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild settings

**Slug:** `DISCORDBOT_UPDATE_GUILD`

Updates settings for a Discord guild (server). Requires the MANAGE_GUILD permission. All parameters except guild_id are optional -- only include the settings you want to change.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild application command

**Slug:** `DISCORDBOT_UPDATE_GUILD_APPLICATION_COMMAND`

Updates properties of a guild-specific application command. Omitted properties remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the command (1-32 characters). |
| `options` | array | No | New list of command option objects. If provided, all existing options are overwritten. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild. |
| `command_id` | string | Yes | The unique identifier (snowflake ID) of the command to update. |
| `description` | string | No | New description for the command (1-100 characters). |
| `dm_permission` | boolean | No | Whether available in DMs. Not supported for guild commands; will be ignored. |
| `application_id` | string | Yes | The unique identifier (snowflake ID) of the Discord application. |
| `name_localizations` | object | No | Localization dictionary mapping locale codes to localized names. |
| `description_localizations` | object | No | Localization dictionary mapping locale codes to localized descriptions. |
| `default_member_permissions` | string | No | Bitwise permission flags string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild emoji

**Slug:** `DISCORDBOT_UPDATE_GUILD_EMOJI`

Updates a custom emoji's name and/or role restrictions in a Discord guild; cannot create or delete emojis, and role updates for managed emojis may be restricted by their integration.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Modify guild member details

**Slug:** `DISCORDBOT_UPDATE_GUILD_MEMBER`

Updates a guild member's attributes including nickname, roles, voice state, timeout status, and flags. Only provided fields will be updated. Requires appropriate permissions for each operation.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Modify guild role

**Slug:** `DISCORDBOT_UPDATE_GUILD_ROLE`

Updates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon` | string | No | New role icon as base64 encoded image data. Mutually exclusive with unicode_emoji. |
| `name` | string | No | New name for the role (max 100 characters). |
| `color` | integer | No | New color as an integer representation of a hex code (0 for no color). |
| `hoist` | boolean | No | Whether to display the role separately in the member list. |
| `role_id` | string | Yes | The unique identifier (snowflake ID) of the role to be updated. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the guild containing the role. |
| `mentionable` | boolean | No | Whether to allow anyone to mention this role. |
| `permissions` | string | No | Bitwise value for new role permissions. |
| `unicode_emoji` | string | No | New unicode emoji for the role's icon. Mutually exclusive with icon. Requires ROLE_ICONS guild feature. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild scheduled event

**Slug:** `DISCORDBOT_UPDATE_GUILD_SCHEDULED_EVENT`

Updates 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild sticker info

**Slug:** `DISCORDBOT_UPDATE_GUILD_STICKER`

Modifies a guild sticker's name, description, or tags. Requires MANAGE_EXPRESSIONS permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the sticker (2-30 characters). |
| `tags` | string | No | The Discord name of a unicode emoji representing the sticker's expression (2-200 characters). |
| `guild_id` | string | Yes | ID of the guild where the sticker is located. |
| `sticker_id` | string | Yes | ID of the sticker to be updated. |
| `description` | string | No | New description for the sticker (2-100 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild template

**Slug:** `DISCORDBOT_UPDATE_GUILD_TEMPLATE`

Updates a Discord guild template's name and/or description; omitted fields retain current values, and an empty string for description clears it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the guild template; if omitted, the current name is retained. |
| `guild_id` | string | Yes | Unique identifier of the Discord guild where the template resides. |
| `description` | string | No | New description for the guild template; if omitted, the current description is retained. An empty string clears it. |
| `template_code` | string | Yes | Unique code of the guild template to be updated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild welcome screen

**Slug:** `DISCORDBOT_UPDATE_GUILD_WELCOME_SCREEN`

Updates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enabled` | boolean | No | Whether the welcome screen is enabled. |
| `guild_id` | string | Yes | The unique ID (snowflake) of the guild whose welcome screen is to be updated. |
| `description` | string | No | The server description to show in the welcome screen. Set to null to remove. |
| `welcome_channels` | array | No | An array of welcome channel objects (max 5). Set to null or empty list to remove all. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update guild widget settings

**Slug:** `DISCORDBOT_UPDATE_GUILD_WIDGET_SETTINGS`

Updates a Discord guild's widget settings, such as its enabled state or invite channel. Requires MANAGE_GUILD permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enabled` | boolean | No | Enables (true) or disables (false) the guild widget. Omit to leave unchanged. |
| `guild_id` | string | Yes | Unique ID (snowflake) of the Discord guild whose widget settings are to be updated. |
| `channel_id` | string | No | The channel ID to set as the widget's invite channel, or null to clear it. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Message

**Slug:** `DISCORDBOT_UPDATE_MESSAGE`

Edits a message previously sent by the bot. Only provide fields you want to change; use null or empty list to clear values.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update my application

**Slug:** `DISCORDBOT_UPDATE_MY_APPLICATION`

Updates settings for the current authenticated Discord application via /applications/@me.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update bot's nickname in guild

**Slug:** `DISCORDBOT_UPDATE_MY_GUILD_MEMBER`

Modifies 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nick` | string | No | The new nickname for the bot in the guild. Set to null or empty to remove. Maximum 32 characters. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild where the bot's nickname will be updated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update current bot user profile

**Slug:** `DISCORDBOT_UPDATE_MY_USER`

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `avatar` | string | No | Base64 encoded image data for the new avatar (format: 'data:image/png;base64,...'). Set to null to remove. |
| `username` | string | No | The new username for the bot user. Must be 2-32 characters. Changes are rate-limited to 2 per hour. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update original webhook message

**Slug:** `DISCORDBOT_UPDATE_ORIGINAL_WEBHOOK_MESSAGE`

Updates the original (@original) message previously sent by a webhook or interaction response.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update own voice state

**Slug:** `DISCORDBOT_UPDATE_SELF_VOICE_STATE`

Updates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild. |
| `suppress` | boolean | No | Whether to suppress (mute) the bot in the stage channel. True to suppress, false to unsuppress. |
| `channel_id` | string | No | The ID of the stage channel. Required for stage channel operations. |
| `request_to_speak_timestamp` | string | No | ISO8601 timestamp for requesting to speak. Set to a timestamp to request, or null to clear the request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update user voice state

**Slug:** `DISCORDBOT_UPDATE_VOICE_STATE`

Updates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier (snowflake ID) of the user whose voice state to update. |
| `guild_id` | string | Yes | The unique identifier (snowflake ID) of the Discord guild. |
| `suppress` | boolean | No | Whether to suppress (mute) the user in the stage channel. True to suppress, false to unsuppress. Requires MUTE_MEMBERS permission. |
| `channel_id` | string | No | The ID of the stage channel where the user is participating. Required for stage channel operations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update webhook details

**Slug:** `DISCORDBOT_UPDATE_WEBHOOK`

Updates properties of an existing Discord webhook such as name, avatar, or channel.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New default name for the webhook. |
| `avatar` | string | No | Data URI for the new webhook avatar image. Set to null to remove the avatar. |
| `channel_id` | string | No | ID of the new channel to move the webhook to. |
| `webhook_id` | string | Yes | The unique identifier of the webhook to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update webhook by token

**Slug:** `DISCORDBOT_UPDATE_WEBHOOK_BY_TOKEN`

Updates a Discord webhook's name and/or avatar using its ID and token, without bot authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New default name for the webhook (1-80 characters). |
| `avatar` | string | No | Data URI for the new webhook avatar image. Set to null to remove the avatar. |
| `webhook_id` | string | Yes | The unique identifier of the webhook to update. |
| `webhook_token` | string | Yes | The secure token of the webhook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update webhook message

**Slug:** `DISCORDBOT_UPDATE_WEBHOOK_MESSAGE`

Updates a message previously sent by a webhook, allowing modification of content, embeds, attachments, or components.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |