Audit Trail
Every agent keeps a complete history of changes made to its configuration — who changed what, and when. The Audit Trail is where you read that history, making it easy to hold people accountable and to debug surprises like "who changed the instructions yesterday?".
Who can view the Audit Trail? Only Owner and Admin.
Why the Audit Trail matters
An agent's behaviour comes from its configuration: its welcome message, its instructions, the contributors assigned to it, and many smaller settings. When that behaviour suddenly changes, you want a clear answer, not guesswork.
The Audit Trail gives you exactly that:
- Accountability — every change is tied to the person who made it.
- Debugging — when an agent starts replying differently, you can see the precise edit that caused it.
- History — you can look back days or weeks to understand how an agent reached its current state.
Think of it as a security camera for an agent's settings: nothing changes without leaving a record.
Where to find it
Open the Organization page → click your organization → Agents tab → find the agent card → View Audit Trail.
This opens the change history for that single agent. Each agent has its own separate trail.
The filter panel
Audit trails can grow long, so a filter panel lets you narrow the log to exactly what you need. You can combine any of these filters:
| Filter | What it does |
|---|---|
| Entity Type | Limit to one kind of object that was changed (for example the agent itself, or a related entity). |
| Action | Show only Create, Update, or Delete events. |
| Actor ID / Actor Email | Show only changes made by one specific person. |
| Field Name | Show only changes to one named field, e.g. the welcome message. |
| Timestamp (from / to) | Restrict to a date-and-time range. |
When your filters are ready, click Apply. To start over, click Clear and the full log returns.
Reading the results table
The matching changes appear in a table with these columns:
| Column | Meaning |
|---|---|
| Entity type | The kind of object that changed. |
| Action | Create, Update, or Delete. |
| Actor | The name or email of the person who made the change. |
| Timestamp | When the change happened. |
| Field name | Which field was affected. |
| Old value | The value before the change. |
| New value | The value after the change. |
Each row is clickable — selecting a row opens a detail view of that single entry, where you can read the full before-and-after for a change that is too long to fit in the table.
Tip: The list shows 20 records per page by default, with pagination at the bottom. You can adjust the page size if you prefer to see more at once.
Worked example
Goal: Dina wants to know who edited an agent's welcome message and what it used to say.
- She opens the agent card and clicks View Audit Trail.
- In the filter panel she sets Actor Email =
dr. Budi's email and Action = Update.- She clicks Apply.
- The table shows a row from yesterday: Field name = welcome message, Old value = the previous greeting, New value = the new greeting.
- She clicks the row to read the full old and new text side by side — confirming Budi made the change.
Next step
Return to Agents in an Organization to manage agents, or learn how spending works across the whole organization in Billing & Credits.