Platform Admin Service — Event Schemas

Status: populated Owner: TBD Last updated: 2026-04-18 Companion: 04 Events · NAMING

NATS stream: PLATFORM_ADMIN (subjects platform_admin.>) Retention: 90 days (config/flag events); 7 years (health status transitions for audit).

1. Events produced

Event	Subject	Version	Retention
ConfigUpdated	platform_admin.config.updated.v1	v1	90 days
FlagCreated	platform_admin.flag.created.v1	v1	90 days
FlagUpdated	platform_admin.flag.updated.v1	v1	90 days
FlagArchived	platform_admin.flag.archived.v1	v1	90 days
HealthSourceRegistered	platform_admin.health_source.registered.v1	v1	90 days
HealthStatusChanged	platform_admin.health_source.status_changed.v1	v1	7 years

platform_admin.config.updated.v1 payload:

{
  "key": "global.session_idle_minutes",
  "scope": "PLATFORM",
  "tenantId": null,
  "oldValue": "20",
  "newValue": "30",
  "changedBy": "usr_01H..."
}

platform_admin.flag.updated.v1 payload:

{
  "key": "feature.telehealth_beta",
  "defaultEnabled": false,
  "enabledTenantIds": ["ten_01H..."],
  "changedBy": "usr_01H..."
}

2. Events consumed

Event	Subject	Producer	Action
TenantActivated	tenant.tenant.activated.v1	tenant-service	Provision tenant-scoped default config

3. Cache invalidation on events

On platform_admin.flag.updated.v1 or platform_admin.flag.archived.v1: Redis cache keys matching flag:{key}:eval:* are deleted (all tenant evaluations for that flag invalidated within 60 s at most, or immediately on event arrival).