On this page

Golden separates audit events, which explain supported changes, from history records, which retain records needed for operations such as merge undo. Enable the corresponding table controls before data changes occur. Neither reconstructs activity that happened while its control was disabled.

Enable the controls

auditable and history are separate table settings. Auditing can also be enabled or disabled on an existing table by an administrator. Disabling it keeps retained events but opens a gap; re-enabling does not fill that gap. See Audit controls for the procedure.

History is not a version of every business field after every edit. Whether a record enters history depends on the operation and configuration. In particular, merging with history retains contributing records, and deleting with history retains the deleted record. Without retained contributors, merge undo cannot recover them. See Resolve duplicates. Delete, merge and undo each add a history version. Nothing removes a version except a table clear, which also removes its earlier audit events.

Inspect audit and history

Read audit events through the dedicated table record endpoint. An ADMIN or STEWARD needs access to the record; VIEWER cannot read its audit timeline. For Aurelia, set the service URL and an authorized bearer token, then request:

curl --fail-with-body --silent --show-error \
  --header "Authorization: Bearer ${GOLDEN_TOKEN}" \
  "${GOLDEN_URL}/api/tables/sample_customer/records/CRM-0001/audit"

The response contains events. No API record response carries _audit, even when expanded; only a destination payload does. Audit events are read only through the dedicated endpoint. An empty event list does not prove that auditing has always been enabled or that the record never changed.

On an audited table, each inbound write stores the whole document as received in received, including fields a cleaner later cleared or removed. Each changed field can carry an ordered steps chain showing the input and output of its cleaner, transformer, script or transformation. An identical resend also writes an event with empty changes. These values are visible to an authorized audit reader and are retained until the table is cleared; they are never included in a destination payload. Earlier events have no received or steps values.

Read retained history through table record queries with type=HISTORY. History metadata describes the recorded operation and relationships; it does not replace the audit timeline. See Record metadata.

Preserve useful attribution

Give each person a distinct user and each integration its own token. Record a meaningful comment where the operation supports one. Shared credentials weaken attribution. Establish retention and evidence-export requirements with your service agreement; the existence of a timeline alone is not a retention promise.

Golden 3.4.0 · Published 2026-10-29