Actions53
- Message Actions
- Channel Actions
- Thread Actions
- Reaction Actions
- Guild (Server) Actions
- Member Actions
- Role Actions
- Voice Actions
- DM Actions
- Webhook Actions
- Invite Actions
Overview
This node interacts with the Discord API to perform various operations related to Discord roles, specifically including the deletion of roles within a Discord server (guild). It is useful for automating role management tasks such as deleting a role by its ID in a specified guild. This can be applied in scenarios where roles need to be programmatically removed based on workflow conditions or administrative actions.
Use Case Examples
- Automatically delete a role when a project ends to clean up permissions.
- Remove a role from a guild as part of a user offboarding process.
Properties
| Name | Meaning |
|---|---|
| Guild ID | The ID of the Discord server (guild) where the role exists and the deletion will occur. |
| Role ID | The ID of the role to be deleted from the specified guild. |
| Additional Fields | Optional parameters that can be provided for extended functionality or metadata, such as reason for audit logs, permissions, and display options. These fields are not directly used in the delete operation but are available for other role-related operations. |
Output
JSON
success- Indicates if the role deletion was successful (true/false).roleId- The ID of the role that was deleted.
Dependencies
- Discord API
- An API key credential for Discord bot authentication
Troubleshooting
- Role not found error: Ensure the provided Role ID exists in the specified Guild ID.
- Permission errors: The bot must have appropriate permissions to delete roles in the guild.
- Invalid Guild ID: Verify the Guild ID is correct and the bot is a member of the guild.
Links
- Discord.js Role.delete() Method - Official documentation for deleting a role using discord.js library.
- Discord Permissions Documentation - Details on permissions required for role management in Discord.