members_bulk_ban
members_bulk_ban
Section titled “members_bulk_ban”Category: members
Ban many users at once (1-200 per call). DESTRUCTIVE — IRREVERSIBLE without manual unban.
When to use
Section titled “When to use”- Mass moderation (raid response).
When NOT to use
Section titled “When NOT to use”- Single user → use
members_ban.
| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild to ban from |
user_ids | array | yes | Users to ban (1-200 per call) |
delete_message_seconds | integer | no | Delete each user’s messages from the last N seconds (0..604800 = up to 7 days) |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{banned_users:[...], failed_users:[...], banned_count, failed_count\}. Discord returns 200 with both arrays even on partial failure.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
banned_users | array | yes | |
failed_users | array | yes | |
banned_count | integer | yes | |
failed_count | integer | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | yes |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | yes (__confirm:true required) |