# Create Projects and Access Dispensed Data

{% 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 %}

After your data access request is approved, you can create a project where the platform automatically dispenses the requested data into a secure workspace. Both the Request Owner and Collaborators on the approved request can create projects from it.

## How Data Dispensal Works

When you create a project from an approved data access request, the platform automatically begins provisioning your data into the new project by default. You can opt out of automatic dispensal during project creation if needed. This dispensal process includes:

* **Tabular data** from your selected data collections, filtered to the cohort you defined in the request.
* **Bulk files** (for example, sequencing files, imaging data) associated with the selected data collections and cohort.

The dispensal process takes time and varies based on the amount of data in your approved request.

Dispensal always uses the most current active inventory version at the time the dispensal job launches. If the TRE updates its data to a newer version after your request was approved, any project you create draws from that newer version rather than the version that was active when you submitted or received approval for your request. Data providers are expected to maintain field compatibility across inventory versions, so your original cohort query and field selections remain valid on newer data releases. You can see which inventory version was used in the **Research Environment** section of your project settings.

{% hint style="warning" %}
Dispensed data is protected. Objects placed into a research environment project by the dispensal process cannot be deleted by any user. Dispensed data is removed only when the entire project is destroyed.
{% endhint %}

## Research Environment Access Policies in Your Project

Projects created from a research environment data access request inherit the access policies configured by the TRE admin. These policies are enforced within your project and cannot be overridden. They appear in your project settings marked as enforced by the research environment.

Depending on the research environment configuration, the following restrictions may apply to your project:

* **Copy Access** — Whether users can copy data out of the project.
* **Delete Access** — Who can delete data from the project. For example, admin-only or deferred to project settings.
* **Download Access** — Whether data can be downloaded from the project.
* **External Upload Access** — Whether external uploads are allowed.
* **File Preview** — Whether small files can be previewed.
* **Programmatic Database Access** — Whether direct database access is allowed.
* **PHI Data Protection** — Whether PHI protections are enabled.
* **Isolated Browsing Enforcement** — Whether the project enforces isolated browsing.
* **Job Outbound Internet Access** — Whether jobs running in the project can access the public internet.
* **Data Protection Notice** — Whether a data protection notice is displayed.

{% hint style="info" %}
Some of these policies may not appear in your project depending on your organization's licenses and the research environment configuration.
{% endhint %}

These restrictions may limit actions you could normally take in a standard DNAnexus project. During project creation, you can review which policies the research environment enforces before completing the process.

## Default Project Restrictions

Besides the configurable policies above, the following restrictions apply to every TRE project regardless of how the research environment is configured. They cannot be overridden by TRE admins or project members.

* Apps and global workflows cannot be created within TRE projects.
* Moving data between projects is allowed only when both projects are associated with the same data access request. Cloning between TRE and non-TRE projects is not allowed.
* TRE projects cannot be transferred to another owner, and the billing organization cannot be changed.
* Project invitations are limited to users who are already Request Owners or Collaborators on the associated data access request, plus selected support users.

For the full technical reference, see the [Trusted Research Environments API documentation](/developer/api/trusted-research-environments.md).

## Create a Project from an Approved Request

1. In **Data Resources** > **Request Center** > **My Requests**, open an approved request.
2. Click **+ New Project**.
3. In the project creation dialog, complete the following:
   * **Research Environment** section — The linked research environment and request identifier are pre-populated from your approved request and cannot be changed. Review the **Bill To** setting. If the research environment uses a customized rate card, the billing organization must be compatible with it. The **Region** is fixed to the research environment's region and cannot be changed.
   * **Access Policies** section — Review the policies that the research environment enforces. These appear locked and cannot be modified.
   * Remaining project settings — Configure the project name and any other standard project settings.
4. Click **Create Project** to complete the creation.

The platform automatically begins provisioning your approved data into the project. Your project initially appears empty.

### Monitor Dispensal Progress

Your project's dispensal status updates as data arrives. Check the **Research Environment** section in your project settings to monitor progress.

The **Status** field displays:

* **In Progress** — Data is being provisioned into the project.
* **Ready** — Dispensal is complete and your data is available for analysis.

You can also follow the links in the **Research Environment** section back to the source research environment and the original access request to see which inventory version was used for dispensal.

## Manage Projects

You can view all projects associated with a specific research environment from your project list.

1. In the top navigation bar, click **Projects**.
2. Filter the project list by the **Data Resource** column to see projects linked to a specific research environment.

You can also view linked projects from the approved request detail page.

If your request was rejected and you need to revise it, see [Submit a Data Access Request](/user/trusted-research-environments/submitting-access-request.md). For programmatic project provisioning and data access, see the [Data Access Requests API](/developer/api/trusted-research-environments/data-access-requests.md).


---

# 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/user/trusted-research-environments/creating-projects.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.
