K
Docs
API ReferencePiecesKick Member
👢

Kick Member

mod.kickThe Mod SquadModeration

Removes a member from the server — they can still rejoin with an invite. A lighter touch than a ban; great for first offences or automated flows. Always pair with a Condition to confirm the boot is warranted.

When to use this
  • Kicked members can rejoin with an invite — use Ban for permanent removal
  • The reason appears in the server audit log — always fill it in
  • Hook up the Error port — the bot can't kick roles higher than itself

On the canvas

This is what Kick Member looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

👢
Kick Member
mod.kick
Moderation
userIdrequired
{{user.id}}
reason
Breaking rule #4
output
error

Config fields

FieldTypeReqWhat it does
userId
{{user.id}}
textyesWho to kick 👤
reason
Breaking rule #4
textReason (optional) 📋

Output ports

outputKick successful
errorFailed — missing permission or target is higher than the bot in the hierarchy
📐

In TypeScript, this would be…

Not something you need to write — just a look at what Kitcord does for you.

TypeScript
try {
  const member = await guild.members.fetch(userId);
  await member.kick(reason);
} catch {
  // Error port — hierarchy or permissions
}