Skip to main content

Change History

The Change History page at /governance/changes is the audit log for governance metadata — every glossary edit, certification approval, DQ rule change, SLA rule update, and contract version. It complements the operational Audit Trail, which logs jobs and clones.

What's tracked​

Entity typeSource
glossaryBusiness Glossary terms
certificationCertifications & Approvals
dq_ruleData Quality rules
sla_ruleSLA Dashboard rules
contractData Contracts (ODCS + legacy)

Change types​

Each row has a colour-coded badge:

  • Created (green) — new entity added
  • Updated (blue) — fields modified
  • Deleted (red) — entity removed
  • Approved / Rejected (purple) — review-flow transitions

Columns​

  • Change-type icon and badge
  • Entity type
  • Entity ID (clickable — opens the relevant detail page)
  • changed_by (email of the actor)
  • when — relative time-ago format with absolute timestamp on hover

Filter​

A single dropdown at the top filters by entity type. To filter by user or date, export the JSON and grep — there's no in-page user filter today.

API​

GET /governance/changes?entity_type=certification&limit=100

Returns up to limit rows ordered newest-first. For longer windows, paginate by before={timestamp}.

Retention​

Change history is kept indefinitely by default — it's small relative to operational audit. If you need to trim, set governance_change_retention_days in clxs.yaml; older rows are archived nightly to cold storage.

  • Audit Trail — operational job log
  • RBAC — controls who can make changes that land here