From 250a094c45eab37b4eca3bb86520d40a9a38d46a Mon Sep 17 00:00:00 2001 From: Kate Erickson Date: Fri, 6 Nov 2026 13:22:28 -0700 Subject: [PATCH] PDOCS-5005: Insights emails are team contact addresses --- .../insights/insights_create_notificationChannel.yml | 3 ++- .../resources/insights/models/email_notification_config.yml | 5 +++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/specification/resources/insights/insights_create_notificationChannel.yml b/specification/resources/insights/insights_create_notificationChannel.yml index 0bb36a68a..a6ffbb1c6 100644 --- a/specification/resources/insights/insights_create_notificationChannel.yml +++ b/specification/resources/insights/insights_create_notificationChannel.yml @@ -7,7 +7,8 @@ description: | `/v2/insights/notification-channels` with a `name` and exactly one of `email`, `slack`, or `webhook`. - Email recipients must be verified addresses. Webhook URLs must + Email recipients must be team contact emails added and verified by a team + owner. Webhook URLs must use HTTPS. Secret fields (`slack.webhook_url`, webhook credentials) are write-only. Subsequent reads never return secret values; they include optional `*_status` objects when a secret is configured. diff --git a/specification/resources/insights/models/email_notification_config.yml b/specification/resources/insights/models/email_notification_config.yml index ddd54c853..4b8ab917d 100644 --- a/specification/resources/insights/models/email_notification_config.yml +++ b/specification/resources/insights/models/email_notification_config.yml @@ -1,7 +1,8 @@ type: object description: | - Email notification channel configuration. Recipients must be verified email - addresses. + Email notification channel configuration. Recipients must be team contact + emails added and verified by a team owner. They do not need to be team + members. required: - to properties: