Aegis can notify you when your agents trigger governance events, pending approvals, denied actions, rewrites, policy violations, anomalies, and budget thresholds. You choose which channels receive notifications and which events are worth a ping. Configure both from Settings → Notifications.Documentation Index
Fetch the complete documentation index at: https://docs.runaegis.co/llms.txt
Use this file to discover all available pages before exploring further.
Notification channels
Aegis supports three channels. Each channel can be toggled on or off independently.Email
Email notifications are always available and require no additional setup. When enabled, Aegis sends alerts to the email address associated with your account. You can update that address in Settings → Profile.Email is on by default. Toggle it off in Settings → Notifications if you prefer to receive alerts through another channel only.
Webhook
Webhook
Webhook notifications deliver a signed JSON payload to an endpoint you control. Enabling this channel requires at least one webhook endpoint to be registered in Settings → Webhooks. If no endpoints are configured, toggling this on has no effect.For instructions on adding an endpoint and verifying payload signatures, see Webhooks.
Slack
Slack
Slack integration is coming soon. When it becomes available, you will be able to connect a Slack workspace and forward alerts to a channel of your choice. The toggle is visible in Settings → Notifications but is not yet active.
Event types
Aegis generates six categories of governance events. You can enable or disable each one independently, a channel only receives events that are toggled on.| Event | Label | Description |
|---|---|---|
approval | Approval requested | An agent action was held in the approval queue and needs your review. |
denied | Action denied | A policy blocked an agent action from executing. |
rewrite | Action rewritten | Aegis redirected an agent action to a safer path, for example, converting a direct push to a pull request. |
policy | Policy violated | A configured governance rule fired on an agent action. |
anomaly | Session anomaly | Aegis detected unusual agent behavior in a session. |
budget | Token budget threshold | Your token spend hit 75%, 90%, or 100% of your configured cap. |
Configure channels and events
Open notification settings
In the Aegis dashboard, click Settings in the sidebar and select Notifications.
Enable the channels you want
In the Channels card, toggle on the delivery methods you want to use. To use Webhook, make sure you have at least one endpoint configured in Settings → Webhooks first.
Choose which events to receive
In the Events card, toggle each event type on or off. All six events are enabled by default. Disable any that are not relevant to your workflow.
Channel and event settings are per-account. If you are using rooms with multiple members, each member configures their own notification preferences independently.