Skip to main content

Customer Portal — Event Schemas

Status: populated Owner: Product Engineering (Frontend) Last updated: 2026-04-18

1. Not Applicable

The customer-portal is a REST-only stateless frontend. It does not publish or consume events on NATS JetStream or any message broker.

All business events (message delivered, API key created, webhook fired) are published by backend services and consumed by other backend services. The portal receives their effects through synchronous REST API responses.

2. Browser Events (Internal UI Only)

The following custom browser events are dispatched within the portal for cross-component communication. These are not platform events.

Event NameDispatched byConsumed byPayloadPurpose
cust:api-key-createdApiKeyCreateModalKey list server component refresh{ keyId: string }Trigger list revalidation after modal close
cust:webhook-deletedWebhook delete handlerWebhook list{ webhookId: string }Optimistic UI removal

These events use the standard browser CustomEvent API on window and are scoped to the current tab session only.

3. SSE / WebSocket

The customer-portal does not use Server-Sent Events or WebSockets. Message log pages are static-at-load with manual refresh. Real-time delivery updates are not shown in the MVP.