# Manage ICA storage

{% hint style="info" %}
**Prerequisites for managing ICA storage**

To manage ICA storage, the user must have:

* The Storage Provider [user role](/emedgene/emedgene-analyze-manual/settings/user_roles.md)
* [Upload and download permissions](https://help.connected.illumina.com/connected-analytics/project/p-team#upload-and-download-rights) on the ICA project—either granted individually or via entire workgroup
  {% endhint %}

## How to get your ICA credentials:

{% stepper %}
{% step %}
Log in to your Illumina private domain via URL in the following format: [`yourcompanyname.login.illumina.com`](https://yourcompanyname.login.illumina.com). This opens the Connected Platform Home
{% endstep %}

{% step %}
In the left navigation panel: User > API keys
{% endstep %}

{% step %}
Name the key
{% endstep %}

{% step %}
Choose one of the following options:

A**. Grant access to all workgroups across the domain**\
If your domain includes multiple workgroups and you want the API key to apply universally, select "All current and future Workgroups and roles (Global API Key)"

**B. Grant access to specific workgroups**\
Select one or more workgroups from the list. For each selected workgroup, assign the following application roles:

* Emedgene Has Access
* Illumina Connected Analytics - Has Access
* Platform-home Workgroup Admin
  {% endstep %}

{% step %}
Click Generate.\
Once the API key is generated, copy it to your clipboard or download it as a file.

⚠️ Important:\
The API key is only accessible while the API Key Generated popup window is open.\
After closing the window, the key cannot be retrieved. If you didn’t copy or download it, you’ll need to generate a new key.
{% endstep %}
{% endstepper %}

## To connect ICA:

{% stepper %}
{% step %}
Log into your Emedgene domain and go to the workgroup where you want to link ICA storage
{% endstep %}

{% step %}
Click on the user avatar and select Settings from the dropdown
{% endstep %}

{% step %}
Select the Management tab
{% endstep %}

{% step %}
In the Storage card, click Add Storage
{% endstep %}

{% step %}
Select Illumina Connected Analytics (not Illumina Connected Analytics V1!) from the Storage type dropdown
{% endstep %}

{% step %}
Fill the storage credentials:

* "Api\_key"—the API key [generated](#how-to-get-your-ica-credentials) before
* "Project"—the name of the Project in ICA that contains and will contain the data you want to connect
* "Path"—the folder within the project where the data is located. This can be used to restrict the user to only be able to access data within the specified folder. Using only “ / “ will allow all folders within your ICA project
  {% endstep %}

{% step %}
Click Add Storage
{% endstep %}
{% endstepper %}


---

# 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://help.connected.illumina.com/emedgene/emedgene-analyze-manual/managing_data_storage/manage-ica-storage.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.