Admin

Send Test Notification

Send a canned test notification through each configured channel (admin only).

Mirrors detect_embedding_dims: admin-gated probe that reports per-channel reachable/error in a 200 body without leaking secrets or raising 5xx on a bad channel.

Per-channel approach (not EnvConfiguredNotificationSink.deliver) is used so each channel's success/failure is captured in its own NotificationTestChannelResult for display in the admin UI.

post/settings/notifications/test/

Request

  • The document declares no server URL.
  • Auth: one of:
    • OAuth 2 (password, token URL /api/auth/login)
    • API key in header X-Api-Key
    • API key in query parameter api_key

Response

Successful Response

sentboolean required

True if at least one channel successfully delivered the test notification.

messagestring required

Human-readable summary of the test result.

Changes

No recorded changes to this operation across all 50 revisions of this API.