Discord icon

Discord

Interact with Discord API - Full Bot Features

Overview

This node interacts with the Discord API to list all roles in a specified Discord server (guild). It is useful for scenarios where you need to retrieve and manage the roles within a guild, such as for administrative tasks, role audits, or automation workflows involving role data.

Use Case Examples

  1. Listing all roles in a guild to display them in a dashboard.
  2. Retrieving roles to assign or modify permissions programmatically.
  3. Automating role-based notifications or access control based on the roles fetched.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) from which to list all roles.

Output

JSON

  • id - The unique identifier of the role.
  • name - The name of the role.
  • color - The color associated with the role, in hex format.
  • position - The position of the role in the role hierarchy.

Dependencies

  • Discord API access via a bot token credential

Troubleshooting

  • Ensure the provided Guild ID is correct and the bot has permission to access the guild roles.
  • Common errors include 'Role not found' if the role ID is invalid or the bot lacks permissions.
  • Invalid or missing bot token credentials will prevent API access.

Discussion