Realtime events

Realtime events are for awareness and refresh triggers, not large data transfer.

Event shape

{
  "type": "frame.submission.status_changed",
  "tenant_id": "uuid",
  "submission_id": "uuid",
  "agent_id": "uuid",
  "channel_id": "uuid",
  "status": "needs_review",
  "occurred_at": "2026-05-21T10:00:00Z"
}

Event names

frame.submission.created
frame.submission.status_changed
frame.media.status_changed
frame.approval.changed
frame.promoted
frame.rejected
api_key.used
api_key.revoked

The UI fetches the full row after receiving an event.