Docs v1.0 Get Started

Audit Log

The AlgoBridge audit log records every administrative action taken in your workspace — who did what, and when. It is designed for compliance reviews, incident investigation, and change tracking.

What gets logged

The audit log captures all mutations to workspace configuration and membership:

Category Actions logged
Mappings Created, updated (field changes, direction), activated, deactivated, deleted, restored
Members Invited, role changed, removed
Connection PostgreSQL URL changed, Salesforce re-authorized
Billing Plan upgraded, downgraded, subscription cancelled
API Tokens Token created, token revoked
Webhooks Endpoint created, updated, deleted
Settings Workspace renamed, notification preferences changed

Sync engine activity (individual record successes/failures) is tracked in the Monitoring views and the _trigger_log_archive table — not in the audit log.

Viewing the audit log

Go to Settings → Audit Log in your workspace. The log is sorted by most recent first.

You can filter entries by:

  • Actor — the email address of the user who performed the action
  • Action type — e.g. mapping.created, member.invited
  • Date range — events within a specific window

Audit log columns

Column Description
When Timestamp of the action (UTC)
Actor Email of the user (or system for automated actions)
Action Machine-readable event name (e.g. mapping.deactivated)
Resource The object affected (e.g. mapping ID, member email)
Detail Additional context (e.g. which fields changed)

Exporting as CSV

You can export the full audit log — or a filtered subset — as a CSV file.

From the UI

  1. Go to Settings → Audit Log
  2. Apply any filters you want (date range, actor, action type)
  3. Click Export CSV — the file downloads immediately

The exported CSV includes all columns and respects the active filters. Date/time values are in ISO 8601 UTC format.

Via API

curl -H "Authorization: Bearer sfbs_tok_xxxxxxxxxxxx" \
  "https://your-instance.example.com/api/v1/t/{workspaceId}/audit-log?format=csv" \
  --output audit-log.csv

See the API Reference for the full list of filter parameters.

Retention

Audit log entries are retained for 1 year and then purged. If you need longer retention, export to CSV on a regular schedule (e.g. via a cron job against the API endpoint) and archive the files in your own storage.

Audit log vs trigger log

Audit Log _trigger_log
Tracks Configuration changes Data record changes
Who Human actors (workspace members) The sync engine
Where Platform database Your client PostgreSQL database
Retention 1 year 31 days (then archived)
Access Settings → Audit Log, API Direct SQL or Explorer
← Back to AlgoBridge Get Started →