Notifications
Channel configuration and delivery health over REST.
| Method | Path | Summary | Flags |
|---|---|---|---|
| GET | /notifications/channels | List configured channels and their states. | |
| GET | /notifications/status | Per-channel delivery health and recent failures. | |
| POST | /notifications/test/{channel} | Send a synthetic notification to verify a channel. |
GET /notifications/channels
List configured channels.
{
"channels": [
{
"id": "slack",
"type": "slack",
"enabled": true,
"state": "healthy",
"last_delivery": "2026-05-14T09:13:01Z",
"delivered_24h": 412,
"failed_24h": 0
}
]
}
GET /notifications/status
Roll-up status across channels.
{
"channels_total": 5,
"channels_healthy": 4,
"channels_unhealthy": 1,
"delivered_24h": 821,
"failed_24h": 8
}
POST /notifications/test/{channel}
Send a synthetic notification. The body is a stub digest item, useful for verifying HMAC handling on webhook receivers.
Response on success:
{
"delivered": true,
"ms": 312
}
See also
grith notifications- Per-channel guides under Guides
- Notification security model
Last updated: 2026-05-14Edit this page on GitHub →