> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/app/generation/protection-audit-trail.md).

# Tracking and reverting workspace changes

{% hint style="info" %}
**Required workspace permissions:**

* To view the history, **View the Protection Audit Trail**.
* To restore an earlier version, **Configure workspace settings**.
  {% endhint %}

The workspace **Version History** tracks updates related to detecting and protecting sensitive data in the workspace.

You can review the updates and restore the workspace to a specific version.

## Types of actions that the Version History tracks

The **Version History** for a workspace includes the following types of actions:

* Changes to column sensitivity.
* Changes to table mode assignments.
* Changes to the generator assignment.
* Changes to the generator configuration.
* Changes to the subsetting configuration.
* Changes to post-job scripts.

## Displaying the Version History

To display the version history, in the workspace heading, click the history icon.

The **Version History** is grouped by day. The most recent version is at the top of the list.

## Displaying details for a day

By default, each day is collapsed. When you click a day, Structural displays the list of timestamps when changes occurred.

By default, the timestamps are collapsed.

When you expand a timestamp, the details include:

* The specific changes.
* Who performed each change. This might be a specific user or the Structural Agent acting on behalf of a user.
*

```
<figure><img src="/files/9LbbTItSvgsOulUJvhve" alt=""><figcaption><p>Version History panel with an expanded entry</p></figcaption></figure>
```

## Filtering the Version History

To display the available filters, click the filter icon.

<figure><img src="/files/NhvApzk2y2VYx9QsdjgZ" alt=""><figcaption><p>Filters for the workspace Version Jistory</p></figcaption></figure>

### Displaying changes from a specific timeframe

You can filter the version history to view changes from a specific timeframe.

On the filter panel, under **Date**:

1. In the **Start** field, specify the start date for the timeframe to include.
2. In the **End** field, specify the end date for the timeframe to include.

### Displaying specific types of changes

You can filter the version history to only view specific types of changes. For example, you might only want to see changes to column sensitivity.

Under **Change Type**, check the checkbox next to each type of change to include.

### Displaying changes based on who performed them

On the filter panel, under **User**, you can filter the version history to only show actions performed by specific users, including the Structural Agent.

#### **Searching for a user name**

To search for a user by name, in the search field, begin to type the user name. The list of users is filtered to only display matching users.

#### **Setting the type of actor to include**

You can choose to filter actions based on the type of actor that performed the action.

By default, the version history includes actions for all types of actors, both users and the Structural Agent.

To only include actions that a user performed directly, click **User**.

To only include actions that the Structural Agent performed, click **Agent**.

#### Selecting specific users to include

If you configure the version history to include user-triggered actions, then you can limit the history to actions that were performed by specific users.

Check the checkbox next to each user for which to include events in the version history.

## Restoring an earlier version

You can restore the workspace to an earlier version.

Structural can only undo the changes that it tracks. Structural cannot undo the following:

* Actions that you do not have permission to perform.
* Actions that occur outside of the workspace. For example, if a generator preset configuration changed since the version that you are restoring to, that preset configuration is not reverted.
* Changes to the workspace data. Restoring a version does not undo any source data schema changes that occurred since then.
* For child workspaces, changes to the parent workspace configuration.

To restore the workspace to a version, click the **Restore** link for that version.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tonic.ai/app/generation/protection-audit-trail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.