Overview

This node operation fetches the audit log entries from a specified Discord guild (server). It allows users to retrieve detailed records of actions performed within the guild, such as member bans, role changes, or message deletions. This is useful for server administrators or moderators who want to monitor and review administrative activities for security, compliance, or moderation purposes.

Use Case Examples

1. A server admin wants to review the last 50 audit log entries to check recent changes made by moderators.
2. A moderator wants to filter audit logs by a specific action type to investigate a particular event, such as role updates.

Properties

Output

JSON

• id - Unique identifier of the audit log entry.
• action - The action performed in the audit log entry.
• actionType - The type/category of the action performed.
• targetId - The ID of the target entity affected by the action.
• executorId - The ID of the user who performed the action.
• executor
  • id - The ID of the executor user (if available).
  • username - The username of the executor user (if available).
• reason - The reason provided for the action, if any.
• createdTimestamp - Timestamp when the audit log entry was created.
• changes - Details of the changes made in the action.

Dependencies

• Discord API
• An API key credential for Discord bot authentication

Troubleshooting

• Ensure the provided Guild ID is correct and the bot has permission to access the guild's audit logs.
• If no audit log entries are returned, verify the audit log limit and filter parameters are set correctly.
• Common errors include 'Guild not found' or 'Insufficient permissions' which indicate issues with the bot's access rights or incorrect IDs.

Links

• Discord Audit Log Documentation - Official Discord API documentation for audit log endpoints and data structures.