Audit Logs

Introduction to Audit Logs

Audit logs provide a comprehensive record of all actions and changes that occur within your organization. Every create, update, and delete operation is automatically tracked, creating a complete audit trail for compliance, security, and troubleshooting purposes. The system maintains detailed before-and-after snapshots of changes, making it easy to understand what changed, who made the change, and when it occurred.

Understanding Audit Logs

What Gets Logged

The audit system automatically tracks changes to:

Experiments - Creation, status changes, priority updates, and deletions
Documents - Creation, publication, archival, and deletions
Contacts - Contact record modifications
Organizations - Organization settings and configuration changes
Users - User profile updates
Memberships - Team member additions, removals, and role changes
Key Results - OKR key result modifications
Objectives - OKR objective changes
Growth Models - Financial model updates

Action Types

Each audit log entry is categorized by action type:

Action Type	Description
Create	A new entity was created
Update	An existing entity was modified
Delete	An entity was removed
Status Change	The status of an entity changed (grouped with Update)
Comment	A comment was added (grouped with Update)
Assign	An assignment was made (grouped with Update)

Actor Types

Audit logs track who or what performed each action:

Actor Type	Description
Member	Action performed by a team member
System	Automatic system operation
API	Action triggered via API request
Workflow	Action performed by workflow automation
Agent	Action performed by AI agent

Viewing Audit Logs

Accessing Audit Logs

Navigate to the organization Settings
Select Audit Logs from the sidebar
View the chronological list of all logged activities

Audit Log Table

The main table displays:

Column	Description
Date	When the action occurred
Actor	Who performed the action (with avatar)
Actor Type	The type of actor (Member, System, API, etc.)
Action	The type of action performed
Entity Type	What kind of entity was affected
Entity ID	Identifier of the affected entity

Click any row to view detailed information about that specific log entry.

Log Entry Details

Each audit log entry detail view shows four information cards:

Action Card

Action type (Create, Update, Delete)
Precise timestamp of when it occurred

Actor Card

Name of the user or system that performed the action
Actor type classification

Entity Card

Type of entity affected
Entity name (when available)
Entity ID for reference

Details Card

Field-by-field breakdown of changes
Before and after values for each modified field
Clear visual indicators showing old → new values

Filtering and Search

Available Filters

Narrow down audit logs using multiple filter criteria:

Action Type Filter

Filter by the type of action:

All - Show all actions
Create - Only creation events
Update - Modifications (includes status changes, comments, assignments)
Delete - Deletion events

Actor Type Filter

Filter by who performed the action:

All - All actor types
Member - Team member actions
System - System-generated actions
API - API-initiated actions
Workflow - Workflow automation actions
Agent - AI agent actions

Entity Type Filter

Filter by the type of entity affected:

Experiment
Contact
Document
Organization
User
Membership
And more...

Search

Use the search box to find specific entries:

Search by entity type or name
Results update automatically as you type (300ms debounce)
Searches across entity identifiers and names

Sorting

Audit logs are sorted by date by default (newest first). You can toggle between:

Descending - Newest entries first
Ascending - Oldest entries first

Pagination

Navigate through results with pagination controls:

Default page size: 20 entries
Configurable up to 100 entries per page
Page navigation at the bottom of the table

Exporting Audit Logs

Export audit log data for external analysis or compliance reporting.

Selecting Entries

Use checkboxes to select specific log entries
Or use the header checkbox to select all visible entries
Click the Bulk Actions dropdown

Export Options

Format	Description
CSV	Comma-separated values for spreadsheet import
Excel	Native Excel workbook format

Export Contents

Exported files include:

Date and time of each action
Actor name and type
Action type
Entity type and ID
Entity name (when available)

Exporting All Data

To export all audit logs:

Clear any filters to show all entries
Select all entries using the header checkbox
Choose your export format
Download the generated file

Data Retention

Retention Period

Audit logs are retained for 30 days by default. After this period:

Older entries are automatically deleted
Cleanup runs daily at 3:00 AM UTC
Organization-specific and admin logs follow the same retention policy

Compliance Considerations

For organizations with longer retention requirements:

Export audit logs regularly before the retention period expires
Store exported files in your own archival system
Consider setting up automated export workflows

Analytics Integration

Audit log data is available in the analytics system for advanced reporting:

Available Metrics

Metric	Description
Count	Total number of audit entries
Unique Entities	Count of distinct entities affected
Create Count	Number of creation events
Update Count	Number of update events
Delete Count	Number of deletion events
Status Change Count	Number of status change events