Skip to main content

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 delete actions).
  • Date range -- Specify from and to dates 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:

PlanRetention Period
Free7 days
Growth30 days
Pro120 days
Enterprise365 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.