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.

Type
Use

Internal API keys are used to interact programatically with the Panomics platform via the REST API (pre-release) and the CLI.

External API keys enable the ingestion of samples from remote sources such as AWS and DNAnexus.

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.

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.

Create API Key modal dialog
API Key grid immediately after creation

Click the copy icon next to the clear text API key before leaving or refreshing the page.

API Key grid after page refresh

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 for more details.

You can have only 1 external API key per provider.

External API Keys list

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

Create external API key dialog

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

Amazon Web Services

Create an AWS key

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

DNAnexus

Create a DNAnexus key

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

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

External API Key listing

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

Last updated