K
Docs
API ReferencePiecesTimeout Member
⏱️

Timeout Member

mod.timeoutThe Mod SquadModeration

Puts a member in Discord's native timeout. While timed out they can't send messages, add reactions, or join voice. Perfect for automated cool-downs. Requires Moderate Members permission. Max duration is 28 days.

When to use this
  • Set duration to 0 to remove an active timeout early
  • Max is 28 days (2,419,200 seconds)
  • The reason shows in Discord's audit log — always fill it in

On the canvas

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

⏱️
Timeout Member
mod.timeout
Moderation
userIdrequired
{{user.id}}
durationrequired
300 — that's 5 minutes
reason
Spamming in #general
output
error

Config fields

FieldTypeReqWhat it does
userId
{{user.id}}
textyesWho to timeout 👤
duration
300 — that's 5 minutes
numberyesDuration ⏱️ (seconds)
reason
Spamming in #general
textReason 📋

Output ports

outputTimeout applied
errorCouldn't apply — check Moderate Members permission
📐

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.timeout(durationMs, reason);
  // duration 0 clears timeout (see mod.untimeout)
} catch {
  // Error port
}