grith.aidocs

Notifications

Channel configuration and delivery health over REST.

MethodPathSummaryFlags
GET/notifications/channelsList configured channels and their states.
GET/notifications/statusPer-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

Last updated: 2026-05-14Edit this page on GitHub →
© 2026 grith. All rights reserved.