IAA BOT Authorization and Workflows
Understand /authorize, lookup access, workflow submission, reviews, and local workflow state.
Authorization flow#
User runs /authorize
IAA BOT requests an authorization session from the backend
Bot provides an authorization URL
User opens the HTTPS website
User signs in through Discord OAuth2
Website validates the callback and records authorization
Backend determines permitted guild/server information
Staff uses /lookup or related tools
Bot retrieves approved data from the secured API
/authorization-status requests the current backend authorization state for the supported user.
Commands and dependencies#
| Command | Purpose |
|---|---|
/authorize | Creates a backend authorization session and presents the website URL. |
/authorization-status | Runs the authorization status workflow. Discord displays the available parameters when the command is selected. |
/lookup | Retrieves only intelligence approved by the backend for an authorized user. |
/blacklist | Runs the blacklist workflow. Discord displays the available parameters when the command is selected. |
/case | Runs the case workflow. Discord displays the available parameters when the command is selected. |
/permissions | Runs the permissions workflow. Discord displays the available parameters when the command is selected. |
/staff | Runs the staff workflow. Discord displays the available parameters when the command is selected. |
/iaa | Runs the iaa workflow. Discord displays the available parameters when the command is selected. |
/blacklistserver | Runs the blacklistserver workflow. Discord displays the available parameters when the command is selected. |
/blacklistuser | Runs the blacklistuser workflow. Discord displays the available parameters when the command is selected. |
/poach | Runs the poach workflow. Discord displays the available parameters when the command is selected. |
/recruit | Runs the recruit workflow. Discord displays the available parameters when the command is selected. |
/merge | Runs the merge workflow. Discord displays the available parameters when the command is selected. |
/alt | Runs the alt workflow. Discord displays the available parameters when the command is selected. |
/punishment-request | Runs the punishment request workflow. Discord displays the available parameters when the command is selected. |
/review | Runs supported approval or denial actions and synchronizes the decision to the backend. |
Local workflow state#
iaa_workflows.sqlite3 retains some workflow state locally. The website database remains the primary source of truth where strict synchronization is required. Back up the file with the bot configuration, but do not treat it as a replacement for backend persistence.