Audit Log
The audit log records every significant action performed within your BreakGround company, providing a complete trail of who did what, when, and on which resource.
What Gets Logged
Each audit log entry captures:
- Actor -- The team member who performed the action (email resolved automatically).
- Action -- The type of operation (e.g.,
create,update,delete,publish). - Resource -- The affected item (flow, survey, API key, team member, etc.).
- Timestamp -- When the action occurred, displayed in your local timezone.
- Details -- Additional context such as changed fields or configuration values.
Typical logged actions include:
- Creating, editing, publishing, or archiving content (flows, tooltips, surveys)
- Inviting, removing, or changing roles for team members
- Creating or revoking API keys
- Modifying company settings, SSO configuration, or AI configuration
- Ownership transfers
Viewing Audit Logs
Navigate to Settings > Audit Log to see a reverse-chronological list of all company activities. Each entry shows the actor's email, the action performed, the target resource, and the timestamp.
Filtering
Use the filter controls to narrow results:
- User -- Filter by the team member who performed the action.
- Action -- Filter by action type (e.g., only
deleteactions). - Date range -- Specify
fromandtodates to limit the time window.
Filters can be combined. The API supports the same filters via query parameters: action, from, and to.
Retention
Audit log entries are automatically purged once daily based on your plan:
| Plan | Retention Period |
|---|---|
| Free | 7 days |
| Growth | 30 days |
| Pro | 120 days |
| Enterprise | 365 days |
Entries older than your plan's retention period are permanently deleted. System-generated audit logs (e.g., retention purge records) follow the platform log retention period.
Compliance Use Cases
Audit logs support common compliance requirements:
- SOC 2 -- Demonstrate access controls and change tracking.
- GDPR -- Track who accessed or modified personal data.
- Internal reviews -- Investigate unexpected changes or configuration drift.