Notifications Overview

Field	Value
Document ID	ASCEND-NOTIF-001
Version	1.0.0
Last Updated	December 19, 2025
Author	Ascend Engineering Team
Publisher	OW-KAI Technologies Inc.
Classification	Enterprise Client Documentation
Compliance	SOC 2 CC6.1/CC6.2, PCI-DSS 7.1/8.3, HIPAA 164.312, NIST 800-53 AC-2/SI-4

Reading Time: 5 minutes | Skill Level: Intermediate

Overview

ASCEND provides a comprehensive notification system to keep stakeholders informed of AI governance events. Route alerts to the right teams via webhooks, Slack, Microsoft Teams, email, or PagerDuty.

Notification Architecture

Node	Details
Action Events	submitted, approved, denied, executed
Security Events	alert, anomaly, lockout, kill_switch
System Events	health_degraded, integration_error, maintenance, policy_sync
Routing Engine	Event type matching, Risk level filtering, Team assignment, Rate limiting
Webhooks	HMAC-SHA256 signatures, Retry logic
Slack	Bot/App integration, Rich messages
MS Teams	Connector integration, Adaptive cards
Email	SES/SMTP delivery, Templates
Delivery Tracking	Delivery status, Response times, Retry counts, Dead letter queue, Success rates, Audit logging

Notification Channels

Channel	Use Case	Features
Webhooks	Custom integrations	HMAC signatures, retry logic
Slack	Team collaboration	Rich formatting, buttons
MS Teams	Enterprise collaboration	Adaptive cards
Email	Formal notifications	Templates, attachments
PagerDuty	On-call alerting	Escalation policies

Event Types

Action Events

Event	Description	Default Channel
action.submitted	New action submitted	Webhook
action.approved	Action approved	Slack/Teams
action.denied	Action denied	Email + Slack
action.executed	Action executed	Webhook
action.failed	Execution failed	PagerDuty

Security Events

Event	Description	Default Channel
security.alert	Security alert	PagerDuty
security.anomaly	Anomaly detected	Slack + Email
security.lockout	Account locked	Email
security.kill_switch	Kill-switch activated	All channels

Agent Events

Event	Description	Default Channel
agent.registered	New agent	Slack
agent.deactivated	Agent disabled	Email
agent.killed	Agent terminated	PagerDuty

Quick Setup

1. Create Webhook Subscription

curl -X POST "https://pilot.owkai.app/api/webhooks" \
  -H "Authorization: Bearer <admin_jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Security Alerts",
    "target_url": "https://your-app.com/webhooks/ascend",
    "event_types": ["security.alert", "security.anomaly", "agent.killed"],
    "rate_limit_per_minute": 100
  }'

2. Configure Slack Integration

curl -X POST "https://pilot.owkai.app/api/notifications/slack" \
  -H "Authorization: Bearer <admin_jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://hooks.slack.com/services/T00/B00/xxx",
    "channel": "#ai-governance",
    "event_types": ["action.denied", "security.alert"],
    "mention_on_critical": "@security-team"
  }'

3. Configure Email Notifications

curl -X POST "https://pilot.owkai.app/api/notifications/email" \
  -H "Authorization: Bearer <admin_jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": ["security@company.com", "ai-ops@company.com"],
    "event_types": ["action.denied", "agent.killed"],
    "digest_mode": false,
    "template": "security_alert"
  }'

Notification Preferences

Per-User Preferences

curl -X PUT "https://pilot.owkai.app/api/notifications/preferences" \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email_enabled": true,
    "slack_enabled": true,
    "digest_frequency": "daily",
    "quiet_hours": {
      "enabled": true,
      "start": "22:00",
      "end": "08:00",
      "timezone": "America/New_York"
    }
  }'

Organization Defaults

curl -X PUT "https://pilot.owkai.app/api/admin/notifications/defaults" \
  -H "Authorization: Bearer <admin_jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "require_critical_notifications": true,
    "max_notifications_per_hour": 50,
    "escalation_enabled": true,
    "escalation_delay_minutes": 15
  }'

Delivery Guarantees

Feature	Description
At-least-once delivery	Retries on failure
Exponential backoff	1s, 2s, 4s, 8s, 16s
Dead letter queue	Failed messages preserved
Delivery confirmation	Response tracking
Idempotency keys	Duplicate prevention

Metrics

# Get notification metrics
curl "https://pilot.owkai.app/api/webhooks/metrics" \
  -H "Authorization: Bearer <admin_jwt>"

Response:

{
  "total_subscriptions": 5,
  "active_subscriptions": 4,
  "total_deliveries_24h": 1250,
  "successful_deliveries_24h": 1235,
  "failed_deliveries_24h": 15,
  "success_rate_24h": 98.8,
  "avg_response_time_ms": 245,
  "dlq_unresolved": 3
}

Next Steps

• Webhooks - Custom webhook integrations
• Slack & Teams - Collaboration integrations
• Smart Alerts - Intelligent alerting

---

Document Version: 1.0.0 | Last Updated: December 2025