Skip to main content
Athena records asset edits and privileged administration events in separate histories. Use asset history to trace changes to a sheet, document, or deck. Use the administration timeline to review workspace and user administration.
Asset changes are read in the Activity pane and exported with history_audit_trail. Administration events are read in the Admin Audit Log and exported as CSV. Computer snapshots are read in the Versions pane and link to a conversation.

Three kinds of record, where you read each one, and how you export it.

​
Review an asset’s changes

The Activity pane groups edits by person or Athena activity. It can link an attributed edit to the conversation where Athena made it.
  1. Open the sheet, document, or deck and its Activity pane.
  2. Select Timeline to review changes over time or Sessions to group activity by session.
  3. Review the author and time of the change.
  4. Follow an available conversation link to inspect its context. Opening that conversation requires access to the conversation itself.
History can distinguish a person, Athena, an undo, a restore, and an automatic update. An Athena edit can also identify the person it was made on behalf of. View access lets you inspect change metadata. The history tools leave old and new values out when you do not have edit access to the asset.

​
Request an asset audit export

The history_audit_trail tool exports change rows for one asset in JSON or CSV. You need administrator status and access to the asset in the run’s workspace. Workspace ownership alone does not satisfy the export’s administrator check.
  1. In a session with the history tool available, ask Athena to export the asset’s audit trail.
  2. Identify the asset and the time window you need.
  3. Specify JSON or CSV. Add an author, conversation, or location filter if needed.
  4. Review the export’s complete field and note before treating it as a complete record.
For example, ask: “Use history_audit_trail to export this sheet’s changes from yesterday as CSV, including the completeness note.” JSON returns the rows with completeness information. CSV output returns the CSV text alongside the export’s metadata and note.

​
Check export coverage

An export describes at most 200 activity items in one request. Its complete field is false when the scan is capped or edits cannot be described. The note reports older edits outside the scan and edits missing from the rows. If older edits remain, request narrower time windows. If an edit could not be described, keep that gap with your exported record. An empty value can mean that attribution was not recorded or that your access excludes past values. It is not proof that no change occurred.

​
Review administration events

Athena records privileged administration events: workspace membership and role changes, administrator grants and revocations, primary-workspace transfers, and users created by an administrator. Each row has the time, event, outcome, actor, target user, workspace, and request details when available. The Admin Audit Log screen shows these events to deployment administrators. It is in beta and is not listed in the sidebar yet. Ask Athena support for access.
  1. Open Admin Audit Log as a deployment administrator.
  2. Set Event type and Outcome as needed.
  3. Narrow by Workspace ID, Actor user ID, or Target user ID.
  4. Set From and To for the time window.
  5. Expand a row to review its details.
  6. Load more rows until Loaded matches Total events.
  7. Select Export CSV. The button reads Export loaded while matching rows remain unloaded.
The CSV contains the loaded rows only. Compare Loaded with Total events before you treat it as the full set.

​
Review Computer snapshot provenance

When Computer snapshots are enabled and available for the asset, their records include the capture trigger, time, creator identifier when recorded, and associated conversation and message identifiers when available. In a Computer’s Versions pane, a run-completion snapshot can link to the conversation that captured it. Manual and safety snapshots may have no conversation link.

​
Retrieve records on demand

These exports are pulled on demand. Athena does not stream asset history or administration events to a SIEM. To feed one, export on a schedule and keep each export’s time window, filters and completeness note with the file.