Documentation Index
Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt
Use this file to discover all available pages before exploring further.
Notification settings control how and when Kubiya alerts you about important events. Configure channels, event types, and delivery preferences.
Access
Access notifications through:
- Notification bell icon in the header bar
- User menu > notification preferences
Notification preferences may also be available through Organization settings depending on your access level.
Notification Types
Task Notifications
| Event | Description |
|---|
| Task Started | A task begins execution |
| Task Completed | A task finishes successfully |
| Task Failed | A task encounters an error |
| Task Waiting | A task needs user input |
Agent Notifications
| Event | Description |
|---|
| Agent Error | An agent encounters a critical error |
| Agent Offline | A worker disconnects |
| Execution Limit | Approaching usage limits |
System Notifications
| Event | Description |
|---|
| Source Sync Failed | Data ingestion error |
| Security Alert | Detected security issue |
| Scheduled Job Failed | Background job error |
Notification Channels
In-App Notifications
- Click the bell icon in the header to view notifications
- Unread count shows as a badge
- Mark as read individually or all at once
Email Notifications
Configure email delivery:
- Enable email notifications
- Set frequency (immediate, daily digest, weekly digest)
- Select which events trigger emails
Slack Notifications
Connect Slack for team-wide alerts:
- Click Connect Slack
- Authorize the Kubiya app
- Select channels for different notification types
- Configure mention preferences
Configuring Preferences
Per-Event Settings
For each event type, configure:
- Enabled/Disabled - Whether to receive this notification
- Channel - Where to deliver (in-app, email, Slack)
- Priority - Normal or High (affects delivery timing)
Quiet Hours
Set times when non-critical notifications are held:
- Enable quiet hours
- Set start and end times
- Select timezone
- Critical notifications still deliver immediately
Filtering
Filter notifications by:
- Project
- Agent or Team
- Environment
- Severity level
Notification Center
Access the notification center from the bell icon:
View Notifications
- All - Complete notification history
- Unread - Notifications not yet viewed
- Mentions - Notifications where you’re mentioned
Actions
- Mark as Read - Clear the unread indicator
- Mark All as Read - Clear all unread
- View Details - Open related resource
- Delete - Remove from history
Best Practices
Reduce Noise
- Disable notifications for routine events
- Use digests instead of immediate delivery
- Set up filters for specific projects or environments
Critical Alerts
For important events:
- Enable multiple channels (in-app + Slack)
- Set high priority
- Exclude from quiet hours
Team Coordination
For team-wide visibility:
- Send to shared Slack channels
- Use project-based filtering
- Configure different channels for different teams
Slack Integration
Connecting Slack
- Go to Settings > Notifications
- Click Connect Slack
- Select your Slack workspace
- Authorize permissions
- Choose default channels
Channel Configuration
Map notification types to channels:
| Notification Type | Suggested Channel |
|---|
| Task failures | #kubiya-alerts |
| Security issues | #security-alerts |
| General updates | #kubiya-notifications |
Mentions
Configure who to @mention for critical alerts:
- Specific users
- User groups
- Channel (@channel, @here)
Troubleshooting
Not Receiving Notifications
- Check notification settings are enabled
- Verify your email is correct
- Check spam/junk folders
- Ensure Slack app has channel access
Too Many Notifications
- Reduce event types enabled
- Switch to daily digests
- Add filters by project/environment
- Set up quiet hours
Related Pages
