Slash commandModeration

ban

Ban a member permanently or for a selected duration and record the action as a case.

Usage

/ban <user> <reason> [delete_messages] [file] [duration] [custom-duration]

<angle brackets> are required; [square brackets] are optional.

Required user permissions

modules.cases.case.ban.create

Required bot permissions

Ban Members

Discord role hierarchy must also place Archivian above the target member.

user user

Required

The user to ban.

reason string

Required

Why the member is being banned. Maximum 512 characters.

delete_messages integer

Optional

How much recent message history Discord should remove.

Default: Don't delete any

Choices:Don't delete anyPrevious 24 hoursPrevious 48 hoursPrevious 7 days

file attachment

Optional

Proof or supporting context for the case.

duration integer

Optional

A predefined temporary-ban duration.

Default: Permanent

Choices:10 seconds30 minutes1 hour3 hours12 hours1–3 days1 week1 month6 months

custom-duration string

Optional

A custom duration such as 1d12h. Overrides the preset when supplied.

Ban a member permanently and remove one day of messages.

/ban user:@Spammer reason:"Advertising" delete_messages:"Previous 24 hours"

Temporarily ban a member for two weeks.

/ban user:@Member reason:"Repeated raids" custom-duration:2w