Modbot Docs
APIAPI referenceDiscord

Unban on Discord

DELETE/api/discord/bans/{id}

Lift one person's Discord ban. The address names their Discord id; reason goes to Discord's audit log with your account's name. One request, never retried. Once Discord accepts, the audit log records who asked. changed is false when they were not banned. Never the bot's own account, the server's owner or a Discord account linked to a Modbot staff account: those answer 403 refused.

Needs the DiscordUnban permission.

AuthorizationBearer <token>

An API key, made on Settings, API keys. Every key starts with mbk_.

In: header

Path Parameters

id*string

Query Parameters

reason?string

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X DELETE "https://example.com/api/discord/bans/string"
{  "changed": true}

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.

Get the Discord quiet channels list GET

The server's text, announcement and forum channels with when anybody last wrote in each (in the channel or any of its threads), quietest first: channels with no message at all, then the longest since the last message, then channels still being read back with nothing found yet, then channels the bot cannot read. `seenBy` (a role id, repeated for more) keeps the channels at least one of those roles can see, and `notSeenBy` the channels none of them can see: worked out from each role's server-wide permissions, @everyone's, and the channel's own overwrites (a synced channel holds its category's), with Administrator seeing everything, for somebody who holds only that role. A channel whose overwrites or role permissions are not read yet matches neither. Channels @everyone cannot see are listed by name only for someone who can also change settings; for everyone else they are left out and `staffOnlyHidden` counts them. `roles` and `categories` are what the page offers to narrow by. Read from what the bot already stores; nothing is asked of Discord and nothing is changed. Needs the `ViewAnalytics` permission.

Remove from Discord POST

Remove one person from the Discord server without banning them. The address names their Discord id; `reason` goes to Discord's audit log with your account's name. One request, never retried. Once Discord accepts, the audit log records who asked. `changed` is false when they were not in the server. Never the bot's own account, the server's owner or a Discord account linked to a Modbot staff account: those answer 403 `refused`. Needs the `DiscordKick` permission.