# .forestadmin-schema.json

{% hint style="success" %}
This is the official documentation of the `forestadmin-agent-django` and `forestadmin-agent-flask` Python agents.
{% endhint %}

#### The `.forestadmin-schema.json` file

In your **Development Environments only**, on server start, a `.forestadmin-schema.json` file will be auto-generated. It reflects:

* the **state of your data sources Collections.**
* your **Agent customization**.

{% hint style="info" %}
This file **must be versioned and deployed** for any Remote (test, staging, qa, preprod,...) or Production Environment, as it will be the foundation of your Forest Admin layouts.
{% endhint %}

{% hint style="info" %}
We use the option `isProduction` in the `createAgent` function. Setting this variable to `false` will regenerate a new `.forestadmin-schema.json` file every time your app restarts. Using `true` will never regenerate the file.
{% endhint %}

{% hint style="warning" %}
As a consequence, in Remote and Production Environments, the `.forestadmin-schema.json` file does **not** update according to your data sources schema and customization changes (but follows the `.forestadmin-schema.json` file versioned in the code you deployed).
{% endhint %}

{% hint style="danger" %}
**Do not edit this file manually**, as it could break your interface if the wrong syntax is used.
{% endhint %}

Versioning the`.forestadmin-schema.json` file will also help you visualize your admin panel configuration changes:

![](/files/mgqkHZJ7v4Gi1Fl2qZEF)


---

# 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/developer-guide-agents-python/under-the-hood/forestadmin-schema.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.