Manage Authorities

Authorities define the permissions structure for all Bot functions.

FieldDescription
Authority nameThe name of the permissions group in question.
Require roleIf set, the permission group will be automatically determined for a Bot user based on the presence of the selected Discord role in their profile. Bot users with multiple applicable roles will be assigned the authority with the lowest sort order (the lower the sort-order the higher rank the authority). If a Bot user leaves or is removed from the Discord server, all of their linked Bot authorities are automatically revoked.
Require 2FAIf set, Bot users will be required to have multi-factor authentication set in their Discord profile. Note that there may be a significant delay between a user adding 2FA to their account and this information being sent to the Bot.
Sort orderThe lower the sort order, the higher rank the authority.

Action types

Each authority has a corresponding list of permitted action types.

Action type nameAction type verb
Add a private notenote
Add an altaddalt
Add media banaddmediaban
Add to watchlistwatch
Advanced adminadvanced_admin
Advanced reportingadvanced_reporting
Ban membersban
Change automod settingsautomodadmin
Change channel settingschanneladmin
Change global policiespolicyadmin
Change server settingsserveradmin
Change user authoritiesuseradmin
Clear warningsundmwarn
Delete messagesdeletemessages
Delete reactionsdeletereaction
Expunge from databaseexpunge
Issue chat commandsissuechatcommands
Kick a memberkick
Manage altsmanagealts
Manage XPmanagexp
Manual add pointsmanualpoints
Manual remove pointsmanualremovepoints
Manual renamemanualrename
Map roles to reactionsrolereactions
Mark as trollmarktroll
Mute membersmute
No actionnull
Purge messagespurge
Reminderreminder
Remove AI flagsremove_ai_flags
Remove all reactionsdeleteallreactions
Remove from watchlistunwatch
Remove media banremovemediaban
Remove special characters from namerenamespecial
Rename a userrenameuser
Report a member to Discordreport2discord
Reportingreporting
Restrict name changesrestrict_name_changes
Schedule reminderschedule_reminder
Template admintemplateadmin
Timeout and purgetimeoutpurge
Unban membersunban
Unmark as trollunmarktroll
Unmute membersunmute
Unrestrict name changesunrestrict_name_changes
View member profileviewprofile
View message logsviewmessagelogs
View moderator logsviewmodlogs
Warn members via chatchatwarn
Warn members via chat and delete messagechatwarnanddelete
Warn members via DMdmwarn
Warn members via DM and delete messagedmwarnanddelete

Security

Managing authorities requires that the Bot user has the ‘Change global policies’ authority.

  • Bot users cannot set their own or higher permission levels.
  • Permissions can only be granted if the granting user has that permission set in their authority.

See also

Was this page helpful?