# Manage TRE Lifecycle States

{% hint style="info" %}
Apollo and Trusted Research Environments licenses are required to use Trusted Research Environments on the DNAnexus Platform. [Contact DNAnexus Sales](mailto:sales@dnanexus.com) for more information.
{% endhint %}

This guide covers the lifecycle state operations TRE Admins perform after creating a Trusted Research Environment: transitioning between states, updating the resource inventory, and deleting a TRE. For an overview of the three lifecycle states and what configuration is possible in each, see [Managing Trusted Research Environments](/admin/trusted-research-environments.md#lifecycle-operations).

## Publish a TRE

Publishing transitions a TRE from **Draft** to **Active** state. For the full publish procedure and pre-publish checklist, see [Step 6 in creating a TRE](/admin/trusted-research-environments/creating-a-tre.md#step-6-publish-the-research-environment).

## Deactivate a TRE

Deactivating transitions a TRE from **Active** to **Maintenance** state. While in Maintenance state, the TRE remains visible to Authorized Users in **Data Resources** > **Resource Center** but is marked as under maintenance, and new data access requests cannot be submitted. Existing approved requests and active projects are not affected.

Deactivate a TRE when you need to update the resource inventory with a new version.

1. In your org details, navigate to the **TRE** tab.
2. Click the TRE you want to deactivate.
3. Click **Administrative Actions** (gear icon) at the top right.
4. Select **Deactivate Environment**.
5. Click **Confirm and Deactivate**.

## Reactivate a TRE

Reactivating transitions a TRE from **Maintenance** back to **Active** state. The TRE becomes visible again to Authorized Users, and new data access requests can be submitted.

1. In your org details, navigate to the **TRE** tab.
2. Click the TRE you want to reactivate.
3. Click **Administrative Actions** (gear icon) at the top right.
4. Select **Reactivate Environment**.
5. Review the confirmation message.
6. Click **Confirm and Reactivate**.

## Update Data Access Policies

Data access policies control the security restrictions enforced on all researcher projects in this TRE. You can update them at any time regardless of lifecycle state. Changes take effect immediately on all existing and future projects.

1. In your org details, navigate to the **TRE** tab.
2. Click the TRE you want to edit.
3. Under **Features & Policies**, click **Configure Policies**.
4. For each policy, select an enforcement option. For a description of the three options, see [planning data access policies](/admin/trusted-research-environments/planning-a-tre.md#plan-your-data-access-policies).
5. Click **Save**.

## Update the Resource Inventory

The resource inventory is locked while a TRE is Active. To update it — for example, to publish a new version of your data resources — you must first deactivate the TRE.

1. [Deactivate the TRE](#deactivate-a-tre) to enter **Maintenance** state.
2. Navigate to **Resource Inventory**.
3. Update the **Version** string to reflect the new release, for example `2.0.0`.
4. Update the project ID and object ID fields for any changed resources.
5. [Reactivate the TRE](#reactivate-a-tre) to make the updated inventory available.

Contact [DNAnexus Professional Services](https://www.dnanexus.com/professional-services) for assistance preparing updated File Inventory and Data Collections files.

## Delete a TRE

You can delete a TRE only when it is in **Draft** or **Maintenance** state, and only if no data access requests exist for it.

{% hint style="danger" %}
Deleting a TRE is permanent. It cannot be recovered.
{% endhint %}

If data access requests exist, the delete action is disabled.

1. In your org details, navigate to the **TRE** tab.
2. Click the TRE you want to delete.
3. Click **Administrative Actions** (gear icon) at the top right.
4. Select **Delete Environment**.
5. Click **Confirm and Delete**.


---

# 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://documentation.dnanexus.com/admin/trusted-research-environments/managing-tre-lifecycle.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.