Skip to content

Add moderation audit webhook for /clear and other chat moderation commands #393

Description

@xshion13

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like
A clear and concise description of what you want to happen.
Is your feature request related to a problem? Please describe.

Yes. Channel owners currently do not appear to have an official way to know which moderator executed chat moderation commands such as /clear.

This is a problem because /clear can remove the visible chat history for everyone, and if multiple moderators have permissions, the broadcaster has no reliable audit trail to know who triggered the command, when it happened, or whether it was intentional, accidental, or abusive.

Describe the solution you'd like

I would like Kick to add an official moderation audit event/webhook for moderation commands executed in chat.

For example:

moderation.command.executed

The event payload could include:

{
  "broadcaster": {
    "user_id": 123456,
    "username": "channel_name"
  },
  "moderator": {
    "user_id": 222222,
    "username": "moderator_name"
  },
  "command": "/clear",
  "target_user": null,
  "reason": null,
  "executed_at": "2026-06-23T12:01:00Z",
  "metadata": {
    "messages_cleared": true
  }
}

For user-targeted moderation commands, the same event could include the affected user:

{
  "broadcaster": {
    "user_id": 123456,
    "username": "channel_name"
  },
  "moderator": {
    "user_id": 222222,
    "username": "moderator_name"
  },
  "command": "/timeout",
  "target_user": {
    "user_id": 111111,
    "username": "viewer_name"
  },
  "reason": "spam",
  "executed_at": "2026-06-23T12:01:00Z"
}

Describe alternatives you've considered

One alternative is to save all incoming chat messages through chat.message.sent, but this does not show who executed /clear.

Another alternative is to ask moderators to use a custom bot or external moderation panel, but this is not reliable because moderators can still execute /clear directly in Kick chat.

The existing ban/timeout moderation events are useful, but they do not solve the problem of auditing global chat commands like /clear.

Additional context

This feature would help channel owners maintain accountability and transparency among their moderation team. Commands such as /clear can significantly affect the chat experience, so broadcasters should be able to review who executed them and when.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions