Skip to main content
Version: 1.0.0-beta

Audit Trail

Immutable logging of every action in AIIA for compliance and accountability.

What Gets Logged​

CategoryEvents
Data ChangesCREATE, UPDATE, DELETE on all entities
State TransitionsEngagement, finding, workpaper, report status changes
ApprovalsSignoff, review, approval, rejection
ExportsPDF generation, CSV export, board pack creation
AI ActionsEvery AI request, response, and user action (Apply/Reject)
AuthenticationLogin, logout, failed attempts
AdministrationRole changes, user management, config changes

Event Schema​

FieldTypeDescription
idintEvent ID (auto-increment)
org_idintOrganization
user_idintActing user
usernamevarcharUsername
actionvarcharAction type
resource_typevarcharEntity type
resource_idvarcharEntity ID
detailsjsonBefore/after values, metadata
ip_addressvarcharClient IP
created_attimestampUTC timestamp

Querying Audit Logs​

UI​

  1. Navigate to Audit Logs from the sidebar
  2. Filter by date range, user, action, resource type
  3. Export filtered results as CSV

API​

GET /api/v1/audit-logs?action=CREATE&resource_type=Finding&start_date=2026-01-01

Compliance Uses​

RequirementHow Audit Trail Helps
IIA Standard 2330Documenting workpaper review history
NCA ECCProving access control enforcement
PDPLData access logging for privacy compliance
SOXChange management evidence

Immutability​

Audit log events are:

  • Append-only — no UPDATE or DELETE operations allowed
  • Timestamped — server-side UTC timestamp
  • Identity-verified — user from authenticated JWT
  • Retention-protected — exempt from standard cleanup