Docs / Sentinel / Comandos / /unban
Moderation Server only

/unban

Unban a user by ID

Usage

Generated
/unban <user_id> [reason]
OptionTipoObrigatórioDescrição
user_id text Sim Discord user ID to unban
reason text Não Reason

Who can run it

Generated
Discord defaultMembers with Ban Members
Command Access presetModerator roles
Always allowedThe server owner and, by default, Administrators
Change itDashboard, Services, Sentinel, Commands

The Moderation preset limits it to the roles you mark as moderators. Server owners and Administrators can always run it. How Command Access works.

What the bot needs

Generated

Sentinel is granted these permissions by the invite link. A command that finds one missing replies privately with what it could not do and changes nothing.

Kick MembersBan MembersManage ServerView ChannelSend MessagesManage MessagesEmbed LinksManage NicknamesManage RolesTimeout Members

Comportamento

Checked against the code 2026-09-21

Lifts a ban by user ID. The user_id option is typed as text because a banned user cannot be picked from the member list; paste the ID. Discord shows the command only to members with Ban Members by default. The bot checks Command Access rules, that the Moderation service is enabled ("Sentinel is not enabled for this server."), and that the moderator is an Administrator or holds a moderator role from the Settings page ("No permission.").

The reason is optional and defaults to "Manual unban". The bot lifts the ban, ends any anti-nuke hold on that account, and cancels the pending automatic unban if the ban was temporary. The reply is "User 1234567890 unbanned.", followed by "The scheduled automatic unban was cancelled." when a timer was withdrawn.

No case is opened and nothing is posted to the moderation log channel. If the ID is not a number, or the user is not banned, the moderator gets an error asking them to check the bot's role position and permissions.

Good to know

  • While an anti-nuke panic lockdown is on, only the server owner and the anti-nuke exempt users and roles can run it.
YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction