> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/en/api-references/integrations/filerskeepers.md).

# Filerskeepers

### What is Filerskeepers?

[Filerskeepers](https://www.filerskeepers.co/) is a service that provides **ready-to-use data retention schedules**, covering legal retention requirements from all around the world.\
It helps companies **determine how long to keep or delete each type of data** in order to remain compliant with applicable regulations.

#### Prerequisites

* Have a paid Dastra license
* Have a Filerskeepers account. If you don’t have one yet and you are already a Dastra customer, you can [contact our sales team](https://meetings-eu1.hubspot.com/yann-forveille/rendez-vous-avec-un-expert?message=Filerskeepers+Integration), who can offer you preferential pricing.
* Have set up a data retention repository (“Schedule”) in the Filerskeepers software. The integration requires this repository to access your catalog data.

#### Installation

The setup process is very simple:

* **Go to the Filerskeepers integration page** in the Dastra integrations marketplace:\
  <https://app.dastra.eu/workspace/0/settings/integrations/filerskeepers>
* Click the **“Install”** button.
* **Enter your Filerskeepers administrator account credentials** (email + password). These credentials will allow us to generate an access token for the Filerskeepers API.

  <figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FCls3HcfwabQ0ak8kaPxq%2Fimage.png?alt=media&#x26;token=450bc67c-ed5a-43af-afdb-de14e07738b6" alt=""><figcaption></figcaption></figure>
* A configuration window will appear. This configuration is required to finalize the installation. In the form, select the “Schedule” you want to configure with Dastra.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F50Ptq636RLYEYiIyposg%2Fimage.png?alt=media&#x26;token=2576d278-4e85-4136-a675-0dab1b3026b6" alt=""><figcaption></figcaption></figure>

#### Configuration

* Select the Filerskeepers repository you want to synchronize with Dastra.
* Choose whether you want to enable automatic synchronization of retention periods. (Datasets synchronized with Filerskeepers will be updated every night at 00:00 UTC.)
* Select the people who should be notified in case of modifications/creations of retention periods in the datasets. The selected person will receive an email containing details on the datasets that were updated.
* Checking **"Create new datasets if not exists"** will create a dataset for every data type declared in your Filerskeepers account.

> **ℹ️ Info**\
> Be aware: if you check this box, a large number of datasets will be created automatically in your workspace.

#### Selecting the retention policy

The Filerskeepers connector offers several modes of operation:

* Display of the retention period selector based on your Filerskeepers retention repository (called “Schedule” in the software).

From now on, when you open a dataset in Dastra, in the “Retention Policies” section, a button to select a retention policy will appear.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FxGZOazurdAFSNB9rVQsA%2Fimage.png?alt=media&#x26;token=f8f95095-4069-442a-a264-bfa593bf3bfb" alt=""><figcaption></figcaption></figure>

By clicking this button, you can directly select a dataset from your Filerskeepers repository. **This retention period will be automatically synchronized** with Dastra if you enabled this option in the integration configuration.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FusvwbEFIiUr6K2a5JoMu%2Fimage.png?alt=media&#x26;token=6fae00b9-d7aa-46f9-8496-14c30e3b570d" alt=""><figcaption></figcaption></figure>

Select a dataset by clicking the **"Select"** button.

Once you have selected the retention period, the window will close and the following information will be displayed:

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FjBBUvXxRkiMouICp0t8X%2Fimage.png?alt=media&#x26;token=577a42ba-2881-46ed-a671-2f411da64cb5" alt=""><figcaption></figcaption></figure>

> **ℹ️ Info**\
> Only retention periods related to active data stores will be synchronized.

#### How are data synchronized between Dastra and Filerskeepers?

A number of fields from Filerskeepers are automatically mapped to your retention period:

* **The retention duration** (from)
* **The description of the retention policy**
* **The legal justification, link, and jurisdiction**, which are concatenated into the justification field


---

# 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, and the optional `goal` query parameter:

```
GET https://doc.dastra.eu/en/api-references/integrations/filerskeepers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.