Audit history
Understanding the audit history screen
The audit history screen is where you browse, search and filter the events that MintPress records. It provides a chronological record of every change to MintPress data - user actions, system-generated events and errors - so you can monitor activity, troubleshoot issues and maintain accountability.
A table view is presented upon accessing the audit history screen.
Each row includes:
| Column | Description |
|---|---|
| Source | The specific source affected by the event (e.g. project, agent, asset, scheduled activity, properties, settings, etc.) |
| Type | The event type, with its level shown as a badge and a one-line summary underneath where the event has one. See system event types. |
| Created at | Timestamp for when the event was created. |
| System | Whether it is a system-generated event or a user-generated one. |
| User | The user responsible for triggering the event. |
| Event data | A button that opens the event's data without leaving the table. |
Buttons & links
| Buttons & links | Function |
|---|---|
| Search event type | Filter the events by their type. Press Enter to apply. |
| User | Filter the events by the users who raised them. |
| Event type | Limit the events to Error events, Info events or API events. |
| Created | Filter the events by when they were created. |
| System | Show All events, or only System generated or User generated ones. |
| Clear | Clears all the filters and refreshes the table contents. Shown while a filter is applied. |
| Apply | Applies the filters to the table and refreshes the table contents. |
View the details of an event
Click a row in the audit history table to open that event's details page, which has its own URL to bookmark or share. It shows the event's source, creation time, user and path, and the event's message, progress logs and data in separate tabs. The Event data button in the table opens the same tabs in a dialog.
Node & agent audit history
Projects, environments, assets and agents each have an Audit history tab showing the most recent events generated for them. It presents the same table, columns and filters as the main audit history screen, but is automatically scoped to the current node or agent — any filters you apply narrow that list further.
Changes and workflow runs have an Audit history tab too. A change's tab lists the events raised by the change and its steps; a workflow run's tab lists those raised by the run, its steps, and the changes it started and their steps. See activity details.
The audit history screen and the event details page read from the /api/events endpoint. See filtering events on the API to query the same events from a script.