Skip to main content
These admin routes run the Console’s own notification views (the event matrix and the recent Slack sends card) for a platform API key. An External App is refused with 403, even when it holds the permissions.
  • Event types (GET /api/v3/notification-event-types): List every notification event type in the registry with its payload field names, cluster and per-channel delivery (bell, Slack, email, webhook), and which channels have a registered provider. The key needs all three of audit:read, grants:read and policies:read at platform scope, as the Console’s event matrix does; a key missing any one gets 403.
  • Recent Slack sends (GET /api/v3/notification-slack-sends): List the most recent outbound Slack sends, newest first, with audit:read at platform scope. Pass limit (1 to 200, default 50) and optionally surface to read one surface. A send answers its id, time, surface, event type, outcome and Slack timestamps. It never answers the channel or DM it was sent to, or a failure’s error text, which the Console card shows. Sends are kept for 30 days.
Both are platform operations: the key needs each permission at platform scope, else 403. Neither writes anything.