> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/docs/other/audit-log/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Audit log

## Overview

The Audit log records configuration changes made to your AI Agent, giving administrators a chronological, searchable history of who changed what, when, and through which interface. Each entry captures the activity performed, the entity affected, the actor responsible, and the interface used.

Open the Audit log from the profile menu: select your avatar at the bottom of the sidebar, then choose **Audit log**.

## Use cases

The Audit log helps you maintain accountability and meet security and compliance requirements.

* **Investigate changes**: Trace when a configuration was modified and which actor made the change.
* **Support compliance and security reviews**: Provide an exportable record of administrative activity for audits.
* **Troubleshoot unexpected behavior**: Correlate a change in your AI Agent's behavior with a specific configuration update.

## What the Audit log records

Each entry is organized into the following columns.

| Column        | Description                                                      |
| ------------- | ---------------------------------------------------------------- |
| **Timestamp** | The date and time the activity occurred (in UTC).                |
| **Activity**  | The action performed on the entity.                              |
| **Entity**    | The configuration object that was affected, shown with its name. |
| **Actor**     | The user or API key responsible for the activity.                |
| **Interface** | The interface through which the change was made.                 |

### Activities

Activities describe the action taken: **Created**, **Updated**, **Deleted**, **Activated**, **Deactivated**, **Invited**, and **Executed**.

### Entities

Entities are the configuration objects tracked by the Audit log, including Playbooks, Articles, Knowledge sources, API tools, Code tools, Processes, Greetings, Handoffs, Proactives, Variables, Glossary terms, Coaching, Test Cases, Simulations, Topics, Intents, API keys, Team Access, SSO configuration, and Session limits.

### Interfaces

The interface identifies where a change originated: **Ada Dashboard**, **API**, **MCP**, **Import**, and **Export**.

## View and filter entries

Narrow the Audit log to find specific activity.

* **Date range**: Select a date range to scope entries to a specific period. The Audit log defaults to the last 30 days.
* **Filters**: Build filters on Interface, Actor, Activity, and Entity. Each filter supports an **Is** or **Is not** operator and accepts multiple values.
* **Search**: Use the search box to find entries by entity name.

The Audit log refreshes automatically to surface new activity, and results are paginated.

## Export entries

Select **Download** to export the current view, including any active filters, as a CSV file. Exports are capped at 10,000 rows; if the current view exceeds that limit, narrow the date range or apply filters before exporting.

---

Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry).