Platform

Platform overviewArchitectureWorkflow orchestrationGitOps configurationGovernance and AAAAI and MCPKnowledge and contextRuntime and executionEvidence and monitoring

Use cases

All use casesProduction incidentRelease preparationHotfix to productionSecurity scan triage
Why NopsAIIntegrationsSecurity

Resources

All resourcesAI agent governanceMCP governanceMCP securitySelf-hosted platforms
PricingGitHub

Company

How a run worksAboutContactBook a demo

Notifications

Team-routed mail notifications for run outcomes, approvals, and alerts.

How-toAdministratorOperator

Key points

  • SMTP settings live in setting/system/mail.yaml and are managed through /v1/system/notifications/mail.
  • POST /v1/system/notifications/mail/test sends a test message so delivery can be verified before an incident depends on it.
  • Notification routes are owned per team through /v1/teams/{teamID}/notifications.
  • Run notification lineage follows run_team_path, which is why schedules and external triggers set it.
  • Branding is controlled by NOPSAI_MAIL_LOGO_URL, NOPSAI_MAIL_WEBSITE_URL, NOPSAI_MAIL_SUPPORT_URL, and NOPSAI_MAIL_FOOTER_ADDRESS.

Before you start

Mail settings
SMTP settings configured for the platformcurl -s -H "Authorization: Bearer $NOPSAI_TOKEN" "$NOPSAI_URL/v1/system/notifications/mail" | jq
Team
The team ID that should receive notifications

Steps

  1. 01

    Configure delivery once, at the platform level

    Mail settings are a system concern. Teams choose what they are told about, not how it is delivered.

    Read and update mail settingsbash
    curl -s -H "Authorization: Bearer $NOPSAI_TOKEN" "$NOPSAI_URL/v1/system/notifications/mail" | jq
    curl -sX PUT "$NOPSAI_URL/v1/system/notifications/mail" \
      -H "Authorization: Bearer $NOPSAI_TOKEN" \
      -H "Content-Type: application/json" \
      --data @mail-settings.json
    Replace before running
    • mail-settings.json carries the SMTP host, port, credentials reference, and sender address.
  2. 02

    Send a test before trusting it

    The test route exercises the real delivery path, which is the only way to know the credentials and sender are accepted.

    Send a test messagebash
    curl -sX POST "$NOPSAI_URL/v1/system/notifications/mail/test" -H "Authorization: Bearer $NOPSAI_TOKEN" | jq
    Verify
    • The test message arrives, or the response names the delivery failure.
  3. 03

    Subscribe the team

    Notification settings hang off the team, so ownership decides who hears about a run.

    Read team notificationsbash
    curl -s -H "Authorization: Bearer $NOPSAI_TOKEN" "$NOPSAI_URL/v1/teams/$TEAM_ID/notifications" | jq
    Verify
    • The team lists the events it subscribes to.

How it works

Approval checkpoints are the most valuable notification target: a paused run costs nothing but blocks delivery until someone decides.

Monitoring alert rules are a separate mechanism from run notifications. Rules evaluate metric conditions and produce alert events.

Implementation evidence

  • services/nopsai/notification_schema.go

    Notification route and mail settings schema.