diff --git a/docs/Change_Log.md b/docs/Change_Log.md index 9f57f66fd1..92a3c40d7c 100644 --- a/docs/Change_Log.md +++ b/docs/Change_Log.md @@ -1,5 +1,11 @@ # Change Log +## Guild Audit Log Events + +#### Jan 18, 2023 + +At long last, a new [`GUILD_AUDIT_LOG_ENTRY_CREATE`](#DOCS_TOPICS_GATEWAY_EVENTS/guild-audit-log-entry-create) event has been added to the gateway, allowing your application to react to moderation actions in guilds. The `VIEW_AUDIT_LOG` permission is required in order to receive these events, and the [`GUILD_MODERATION` intent](#DOCS_TOPICS_GATEWAY/gateway-intents) needs to be set when connecting to the gateway. + ## Thread Member Details and Pagination > danger diff --git a/docs/topics/Gateway.md b/docs/topics/Gateway.md index 850f67b2a7..a0aa5f9ae4 100644 --- a/docs/topics/Gateway.md +++ b/docs/topics/Gateway.md @@ -308,7 +308,8 @@ GUILD_MEMBERS (1 << 1) ** - GUILD_MEMBER_REMOVE - THREAD_MEMBERS_UPDATE * -GUILD_BANS (1 << 2) +GUILD_MODERATION (1 << 2) + - GUILD_AUDIT_LOG_ENTRY_CREATE - GUILD_BAN_ADD - GUILD_BAN_REMOVE diff --git a/docs/topics/Gateway_Events.md b/docs/topics/Gateway_Events.md index 6450bbea57..5d044de583 100644 --- a/docs/topics/Gateway_Events.md +++ b/docs/topics/Gateway_Events.md @@ -295,6 +295,7 @@ Receive events are Gateway events encapsulated in an [event payload](#DOCS_TOPIC | [Guild Create](#DOCS_TOPICS_GATEWAY_EVENTS/guild-create) | Lazy-load for unavailable guild, guild became available, or user joined a new guild | | [Guild Update](#DOCS_TOPICS_GATEWAY_EVENTS/guild-update) | Guild was updated | | [Guild Delete](#DOCS_TOPICS_GATEWAY_EVENTS/guild-delete) | Guild became unavailable, or user left/was removed from a guild | +| [Guild Audit Log Entry Create](#DOCS_TOPICS_GATEWAY_EVENTS/guild-audit-log-entry-create) | A guild audit log entry was created | | [Guild Ban Add](#DOCS_TOPICS_GATEWAY_EVENTS/guild-ban-add) | User was banned from a guild | | [Guild Ban Remove](#DOCS_TOPICS_GATEWAY_EVENTS/guild-ban-remove) | User was unbanned from a guild | | [Guild Emojis Update](#DOCS_TOPICS_GATEWAY_EVENTS/guild-emojis-update) | Guild emojis were updated | @@ -586,6 +587,10 @@ Sent when a guild is updated. The inner payload is a [guild](#DOCS_RESOURCES_GUI Sent when a guild becomes or was already unavailable due to an outage, or when the user leaves or is removed from a guild. The inner payload is an [unavailable guild](#DOCS_RESOURCES_GUILD/unavailable-guild-object) object. If the `unavailable` field is not set, the user was removed from the guild. +#### Guild Audit Log Entry Create + +Sent when a guild audit log entry is created. The inner payload is an [Audit Log Entry](#DOCS_RESOURCES_AUDIT_LOG/audit-log-entry-object) object. This event is only sent to bots with the `VIEW_AUDIT_LOG` permission. + #### Guild Ban Add Sent when a user is banned from a guild.