From 8f366babe4d427523b16203c2c351550cf6f6b18 Mon Sep 17 00:00:00 2001 From: Seb Slight Date: Sun, 1 Feb 2026 14:43:54 -0500 Subject: [PATCH] docs(discord): clarify exec approvals UI (#6550) * docs(discord): clarify exec approvals UI * Add link for slash command in Discord exec approvals Updated documentation to include a link for the slash command used in Discord exec approvals. * docs(discord): move exec approvals note * docs(discord): document exec approvals config * docs(discord): reorder exec approvals config --------- Co-authored-by: Luke K (pr-0f3t) <2609441+lc0rp@users.noreply.github.com> --- docs/channels/discord.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/channels/discord.md b/docs/channels/discord.md index 71f34f407..d2198d2d5 100644 --- a/docs/channels/discord.md +++ b/docs/channels/discord.md @@ -222,6 +222,11 @@ Notes: - `requireMention` must live under `channels.discord.guilds` (or a specific channel). `channels.discord.requireMention` at the top level is ignored. - **Permission audits** (`channels status --probe`) only check numeric channel IDs. If you use slugs/names as `channels.discord.guilds.*.channels` keys, the audit can’t verify permissions. - **DMs don’t work**: `channels.discord.dm.enabled=false`, `channels.discord.dm.policy="disabled"`, or you haven’t been approved yet (`channels.discord.dm.policy="pairing"`). +- **Exec approvals in Discord**: Discord supports a **button UI** for exec approvals in DMs (Allow once / Always allow / Deny). `/approve ...` is only for forwarded approvals and won’t resolve Discord’s button prompts. If you see `❌ Failed to submit approval: Error: unknown approval id` or the UI never shows up, check: + - `channels.discord.execApprovals.enabled: true` in your config. + - Your Discord user ID is listed in `channels.discord.execApprovals.approvers` (the UI is only sent to approvers). + - Use the buttons in the DM prompt (**Allow once**, **Always allow**, **Deny**). + - See [Exec approvals](/tools/exec-approvals) and [Slash commands](/tools/slash-commands) for the broader approvals and command flow. ## Capabilities & limits @@ -348,6 +353,7 @@ ack reaction after the bot replies. - `channels` (create/edit/delete channels + categories + permissions) - `roles` (role add/remove, default `false`) - `moderation` (timeout/kick/ban, default `false`) +- `execApprovals`: Discord-only exec approval DMs (button UI). Supports `enabled`, `approvers`, `agentFilter`, `sessionFilter`. Reaction notifications use `guilds..reactionNotifications`: