Discord Guilds
The Discord Guilds view is the admin registry of every Discord server (guild) that has the Lumio Discord bot installed and is linked to a Lumio account. It exists so operators can audit the full set of guild-to-account mappings and forcibly unlink a guild when support cases require it.
Where to find it
Admin sidebar → Discord Guilds (/discord-guilds).
Quick start
- Open Admin → Discord Guilds.
- Scan the table for the guild in question.
- To detach a guild from its account, click the red trash button on the row.
- Confirm the prompt. The mapping row is removed and the bot's association with the guild is dropped.
Detailed walkthrough
Guilds table
Columns:
- Guild - the guild's Discord icon (or an initial avatar) plus the guild name as reported by Discord.
- Guild ID - Discord snowflake ID, in a monospace badge.
- Account - linked Lumio account name plus the first 8 characters of its account ID. It is plain text, not a link.
- Connected At - the date the link was established.
- Actions - a red trash button, gated on
discord-guilds:delete.
A count header reads "{N} guild connection(s)".
The table is not sortable, searchable, or paginated - every mapping is rendered in one list.
Deleting a connection
Clicking the trash button raises a native browser confirm ("Are you sure you want to delete this guild connection?"). Confirming removes the mapping row via the admin mutation. The Discord bot remains a member of the guild itself - you have to remove the bot from the Discord server separately if you want it out of the guild.
Bootstrapping guild mappings
Guild connections are created end-user-side: a user adds Lumio's bot to their Discord server via OAuth invite; Lumio stores the mapping. There is no "create guild connection" button in the admin UI - it is list-and-delete only.
Common scenarios
- Lost admin of a Discord server - the Lumio-owning user left and can no longer manage the bot. Delete the guild connection; the remaining server admins can re-invite the bot under a fresh account.
- Account dissolution - when closing an account, remove any remaining guild connections to stop the bot from responding in those servers.
- Duplicate mapping - if the same guild snowflake appears twice (shouldn't happen, but theoretically), keep the newer row and delete the older.
- Audit - read the Connected At column to spot recent onboardings; the column is not sortable, so scan it by hand.
Permissions
| Action | Permission |
|---|---|
| View guild connections | discord-guilds:read |
| Delete a guild connection | discord-guilds:delete |
Dashboard entry requires admin:access. System admins hold both implicitly.
API
| UI action | GraphQL | REST |
|---|---|---|
| List guild connections | adminDiscordGuilds | GET /v1/admin/discord-guilds |
| Delete guild connection | adminDeleteDiscordGuild | DELETE /v1/admin/discord-guilds/\{guild_id\} |
Tips & gotchas
- The delete action only clears Lumio's DB row. To remove the bot from the Discord server itself, a Discord server admin has to kick the bot (or the bot owner can do it from the Developer Portal).
- Guild connections are keyed by Discord snowflake (guild ID), not by account. Re-inviting the bot from a different Lumio account will create a new mapping only if the old one is deleted first.
- There is no rename / re-account UI. To change ownership, delete and re-invite.
- The Discord global bot token is configured on Providers, not here.
Related
- Providers - Discord global-bot configuration and credentials
- Bot Control - pause / resume the Discord bot per account
- Bot Commands - Discord slash commands and prefix commands