Skip to content

Alerts

Alerts are system-generated notifications displayed in the Admin Portal bell icon.

Alert Events

Event Type Triggered By Visible To
self_signup New tenant self-signup Super_Admin
payment_failed Razorpay payment.failed webhook Super_Admin, Tenant_Admin
subscription_activated Razorpay subscription.activated Super_Admin, Tenant_Admin
subscription_cancelled Razorpay subscription.cancelled Super_Admin, Tenant_Admin
subdomain_provisioned Successful domain provisioning Super_Admin, Tenant_Admin
subdomain_failed Failed domain provisioning Super_Admin, Tenant_Admin
user_invited User invitation sent Tenant_Admin
tenant_suspended Tenant status set to suspended Super_Admin, Tenant_Admin

Scoping

  • Super_Admin sees all platform-wide alerts
  • Tenant_Admin sees only alerts scoped to their own tenants

API

GET  /api/v1/alerts                    # List alerts (scoped by role)
PATCH /api/v1/alerts/:alertId/read     # Mark one as read
PATCH /api/v1/alerts/read-all          # Mark all as read