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