Key points
- SMTP settings live in
setting/system/mail.yamland are managed through/v1/system/notifications/mail. POST /v1/system/notifications/mail/testsends 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, andNOPSAI_MAIL_FOOTER_ADDRESS.
Before you start
- Mail settings
- SMTP settings configured for the platform
curl -s -H "Authorization: Bearer $NOPSAI_TOKEN" "$NOPSAI_URL/v1/system/notifications/mail" | jq - Team
- The team ID that should receive notifications
Steps
- 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 - 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" | jqVerify- The test message arrives, or the response names the delivery failure.
- 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" | jqVerify- 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.goNotification route and mail settings schema.

