# API Keys

Panomics supports 2 types of API keys: `internal` and `external`. Only users whose role includes the *Manage API Keys* permission can access this functionality.

<table><thead><tr><th width="237">Type</th><th>Use</th></tr></thead><tbody><tr><td><a href="#internal">Internal</a></td><td>Internal API keys are used to interact programatically with the Panomics platform via the REST API (pre-release) and the CLI.</td></tr><tr><td><a href="#external">External</a></td><td>External API keys enable the ingestion of samples from remote sources such as AWS and DNAnexus.</td></tr></tbody></table>

To get to the API key management pages, click on your avatar icon in the top right corner, then on the `API Keys` menu item. By default, you will be taken to the internal API keys management page.

<div align="center" data-full-width="false"><figure><img src="/files/m6euWdrAKP4T5oDHFmyD" alt="" width="563"><figcaption></figcaption></figure></div>

### Internal

Typically, you will require only 1 API key, but you can create as many as you need.

To create a new API key, click on the `Create` button in the toolbar. This will open a modal dialog where you can input the API key name and duration. After clicking in the `Submit` button, the API key will appear in the grid. Make sure to copy the key, as you won't be able to see it in clear text again.

<figure><img src="/files/lV5Aud3rPPEGP2FHZuxA" alt=""><figcaption><p>Create API Key modal dialog</p></figcaption></figure>

<figure><img src="/files/x6pfC5435QNARC0ydcrI" alt=""><figcaption><p>API Key grid immediately after creation</p></figcaption></figure>

{% hint style="info" %}
Click the copy icon next to the clear text API key before leaving or refreshing the page.
{% endhint %}

<figure><img src="/files/OSvlGgyUdEORUXB4dpSG" alt=""><figcaption><p>API Key grid after page refresh</p></figcaption></figure>

To delete API keys, select them using the corresponding checkboxes in the grid and click the `Delete` button in the toolbar.

### External

You can navigate to the external API keys page from your Profile page, Billing page, or API Keys page. External API keys are used to integrate with storage providers, such as AWS and DNAnexus. Panomics uses these keys to pull sample files. Refer to [sample ingestion](/documentation/samples/sample-ingestion.md) for more details.

{% hint style="info" %}
You can have only 1 external API key per provider.
{% endhint %}

<figure><img src="/files/yEVub3OdDJVWmFYRdOjy" alt=""><figcaption><p>External API Keys list</p></figcaption></figure>

To create an external API key, click on the `Create` button in the toolbar. A modal dialog will open.

<figure><img src="/files/rZZ09cyFnk6P2vwgP3WY" alt=""><figcaption><p>Create external API key dialog</p></figcaption></figure>

Fill in the label and select the provider: `Amazon Web Services` or `DNAnexus`

#### Amazon Web Services

<figure><img src="/files/cdnTcAQnOFqydgQWJW3D" alt=""><figcaption><p>Create an AWS key</p></figcaption></figure>

Fill in the key, secret, region, and duration, then click the `Submit` button.

#### DNAnexus

<figure><img src="/files/QlCHCnl1SQDDSkHMhL32" alt=""><figcaption><p>Create a DNAnexus key</p></figcaption></figure>

Fill in the key and duration, then click the `Submit` button.

Your external API key listing should display the created external API keys.

<figure><img src="/files/2oLCzj15XvSQKiezpOfF" alt=""><figcaption><p>External API Key listing</p></figcaption></figure>

To delete one or more external API keys, select their corresponding checkboxes and click the `Delete` button in the toolbar.


---

# 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.panomics.bio/documentation/api-keys.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.