Overview
Audits logs every action and change made in Swaarm - across all entities, users, and automated rules. Use it to track what happened, when, and who was responsible.
ℹ️ Audits is accessible to Admin users only. More about user roles here.
Where to Find Audits
Go to: Organization → Audits
Audits Fields Explained
All changes are displayed in chronological order. Use the filters to narrow down results by:
Time - date and time range
Advertisers, Offers, Publishers - filter by specific entities
Advertiser Workflows, Offer Workflows, Publisher Workflows — filter by workflow
Alert Rules - filter by alert rule
Audit Type - type of change (e.g. Click Budget, Offer Access State)
User Types - filter by user type (User, System)
Changed By - filter by the user who made the change
Entity IDs - filter by specific entity ID
Each log entry shows:
The entity affected and its ID
The action taken (Create, Update, Delete, Undo)
The changed fields with previous and current values
The reason - useful for identifying changes made by Workflows or Alerts (e.g. "Workflow action", "Alert 129")
The timestamp
The user who made the change
💡 click on + to see more details:
Quick Access from Entity Pages
On any entity details page (Advertiser/Publisher/Offer), click More → Audits in the top right corner. This opens the Audits page with that entity pre-filtered - no need to search manually.
Reverting Changes
Changes can be reverted directly from the Audit log. Where available, click the Revert button on a log entry to undo the change.
Once the revert is performed, new audit log with operation 'Undo' will appear:
Examples
Investigate who changed a click cap on an offer
Go to Organization → Audits
Filter by Offers = [offer name or ID]
Filter by Audit Type = Click Budget
Look for a log entry where the changed field is Click Cap - it will show the previous and current value, the timestamp, and the user who made the change
Conclusion: click budget was changed from 1000 to 20000 clicks by user id 12 June 12th 14:06.
Find out when and why an offer status changed to 'paused'
Go to Organization → Audits
Filter by Offers = [offer name or ID]
Filter by Audit Type = Offer
Look for a log entry where the changed field is Status and the current value is Paused
Check the Reason field - if it was changed by a Workflow or Alert, this will be indicated there. If changed manually, the user who made the change will be shown. If it is an API offer, you'll see it as changed by the system.
Conclusion: this is an API offer, was paused June 12th 14:20. In order to investigate further, you may ask the Advertiser, as the offer might have beed paused due to a number of reasons: budget reached, you were blocked on the offer, etc.