$unpinMessage
Unpins a specific message from a channel. You can either unpin the message that triggered the command, or unpin a message in another channel by providing the channel and message IDs.
Syntax
$unpinMessage
$unpinMessage[channelID;messageID]
$unpinMessage: Unpins the message that triggered the command. RequiresManage Messagespermission in the channel.$unpinMessage[channelID;messageID]: Unpins a specific message in the specified channel. RequiresManage Messagespermission in the channel specified bychannelID.
Parameters
channelID: (Optional) The ID of the channel where the message to unpin is located.messageID: (Optional) The ID of the message to unpin.Note: If
channelIDis provided,messageIDmust also be provided.
Examples
1. Unpinning the message that triggered the command:
This will unpin the message the user sent that triggered the command (e.g., a command like $unpinMessage).
$unpinMessage
2. Unpinning a specific message in another channel:
This will unpin the message with ID 987654321098765432 from the channel with ID 123456789012345678. Replace these with the actual Channel and Message IDs you wish to unpin.
$unpinMessage[123456789012345678;987654321098765432]
Important Considerations:
- The bot requires the
Manage Messagespermission in the channel where the message is being unpinned. - Make sure the provided
channelIDandmessageIDare valid IDs. - If the message is already unpinned, the function will not return an error.
⏱️ Function Cooldown
This function has a built-in cooldown to help prevent excessive usage.
| Property | Value |
|---|---|
| ⏱️ Duration | 2 minutes |
| 🆔 Tracked By | Message ID |
| 🌐 Scope | Messageupdate |
Functions with the same Scope share cooldowns based on the same
Tracked Byvalue.
💎 Tier 3+ servers bypass this cooldown. See Premium Perks.