Skip to main content

Moderation Events

Moderation action events published on the room-events Kafka topic. These events are emitted when a moderator or host takes action on a participant.

Source: Room Service

moderation_action

FieldTypeRequiredDescription
actor_user_idstring (uuid)YesUser who performed the action.
target_user_idstring (uuid)YesUser the action was performed on.
actionstringYesOne of: mute, unmute, kick, ban, unban, role_change.
reasonstringNoHuman-readable reason for the action.
new_rolestringNoNew role (only for role_change). One of: host, speaker, listener.

Example Payloads

Mute

{
"actor_user_id": "550e8400-e29b-41d4-a716-446655440000",
"target_user_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"action": "mute"
}

Kick with reason

{
"actor_user_id": "550e8400-e29b-41d4-a716-446655440000",
"target_user_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"action": "kick",
"reason": "Disruptive behavior"
}

Role change

{
"actor_user_id": "550e8400-e29b-41d4-a716-446655440000",
"target_user_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"action": "role_change",
"new_role": "speaker"
}