# Export users history

{% hint style="info" %}
You need to be on a [Forest Admin Pro plan](https://www.forestadmin.com/pricing) to have access to this feature.
{% endhint %}

Some organizations with hundreds of collaborators use Forest Admin every day. Administrators of such projects usually need to monitor:

* how users are added to the admin panel,
* which Permission Level, Role, Tags they are given,
* which Teams they are assign to,

by other collaborators authorized to do so.

Such monitoring is possible using the users history export. You can access to this action in the Users Tab of your Project Settings **(1)**. Simply click on the Export dropdown **(2)** and select "Export users history" **(3)**.

<figure><img src="/files/R8V2TWc5czweEMV4H7eM" alt=""><figcaption></figcaption></figure>

The configuration changes that are tracked on the users of you project are:

* Users (update)
  * Projects Assignment (i.e. joins or leaves the project)
  * Teams Assignment (i.e. joins or leaves a team)
  * Role Assignment
  * Permission level Assignment
  * Tags Assignment
* Teams (create / name update / delete)
* Roles (create / name update / delete)

{% hint style="info" %}
As each user change contains information about Teams and Roles with their name at the instant of the change, and as Teams and Roles names can be edited, Teams and Roles are also tracked in the user oriented history to let administrators understand the whole history export.
{% endhint %}

The export will generate a CSV file. Each new line materializes a user change and displays the new value for the affected fields listed above. For example, assigning a user to a new team will log the **complete list of teams** once the new configuration is saved.

As a way to display accurate information, the role and teams contained in each entry will be displayed with the name it had at the date of the change.

Here is an example of export content:

<figure><img src="/files/ZBTxEptne6YIEqfUxLM7" alt=""><figcaption><p>Users history export example</p></figcaption></figure>

Let’s detail each column content:

* **timestamp**: the exact time the configuration event happened,
* **initiator**: the entity that triggered this event. It can be a project administrator (identified by its email), `Forest Admin` (only used to create an initial state right before we started tracking changes: 2023-08-10) and lastly `Identity Provider` if you implemented the user provisioning via [SCIM](broken://pages/-LfsFq-w9HfiEmWnZSns#user-provisioning-scim).
* **action**: the action `add`, `update` or `remove` triggered on the resource
* **resource**: the targeted resource type, it can be `role`, `team` and `user-project` which represents the user in the context of your project.
* **identifier**: the targeted resource identifier, it is either the name (for `role` and `team`) or the email (for a `user-project`).
* **new value**: the resource state for the monitored values in a JSON format.


---

# Agent Instructions: 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.forestadmin.com/user-guide/project-settings/teams-and-users/export-users-history.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.