LogoLogo
Illumina KnowledgeIllumina SupportSign In
  • Home
  • Overview
    • Welcome
    • What's New
      • Cloud Software Update
      • Local Software Update
  • Configure
    • Configuration
      • Custom Case Data
      • Pipeline and QC Configuration
      • Preferred Transcripts
      • Custom Annotations
      • Disease Configuration
      • Variant Filters
      • Variant Flag Groups
      • Actionability Classifications
      • Report Templates
        • Customizations
      • Report Automation
      • Test Definitions
      • Data Upload
        • Data Upload from User Storage (Connected Insights - Cloud and Connected Insights - Local)
        • Data Upload from ICA or BSSH (Connected Insights - Cloud)
        • Supported Pipelines
          • DRAGEN TruSight Oncology 500 Analysis Software v2.6.0 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.6.0
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.3 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.3
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.2 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.5.2
          • DRAGEN TruSight Oncology 500 Analysis Software v2.1.1 (with HRD)
          • DRAGEN TruSight Oncology 500 Analysis Software v2.1.1
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.6.1
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.6.0
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.5.0
          • DRAGEN TruSight Oncology 500 ctDNA Analysis Software v2.1.1
          • DRAGEN Amplicon v4.3
          • DRAGEN Amplicon v4.2
          • DRAGEN Amplicon v4.1
          • DRAGEN RNA v4.3
          • DRAGEN RNA v4.2
          • DRAGEN RNA v4.1
          • DRAGEN Enrichment v4.3
          • DRAGEN Enrichment v4.2
          • DRAGEN Enrichment v4.1
          • DRAGEN for Illumina cfDNA Prep with Enrichment v4.0.3
          • DRAGEN Somatic Whole Genome v4.3
          • DRAGEN Somatic Whole Genome v4.2
          • DRAGEN Somatic Whole Genome v4.1
          • TruSight Tumor 170 Local App v2.0.1
          • Local Run Manager TruSight Tumor 15 Analysis Module v2.1
        • Custom Pipeline Configuration
          • VCF Input Requirement
          • TMB, MSI, GIS Input Requirement
        • Custom Case Data Upload
    • Upload Assertions
    • Local Installation Guide
      • Overview
      • Prerequisites
      • Download Connected Insights Package
      • Install Connected Insights Software
      • Install License File
      • Sign In to Connected Insights
      • Installation Status Messages
      • Local Configurations
      • Administration Console (Connected Insights - Local)
      • Configure External Storage (Connected Insights - Local)
  • Manage cases
    • Cases Page
    • Cases List
      • Case Metadata Upload
  • Interpret and report
    • Case Page
    • Case Details
      • Merge Cases
    • Overview Tab
      • Classification & Risk Stratification Prediction
    • Visualize Tab
    • Variants Tab
      • Modify Columns
      • Apply Variant Filters
        • Filter by Variant Category
        • Variant Details Filters
        • Variant Quality Filters
        • Functional Impact Filters
        • Disease Association Filters
        • Variant Frequency Filters
        • Flags Filter
        • Filtering Logic
      • IGV Visualizations
    • Lab QC Tab
    • Report Tab
    • View Biomarker Details
      • Biological Classification
      • Actionability
      • Clinical Trials
      • Oncogenicity Prediction
      • Visualize
      • Variant Overview
      • Gene Overview
      • Cancer Datasets
      • Computer Predictors
      • Population
    • Interpret a Biomarker
      • Create Clinical Trials
      • Create Gene Descriptions
      • Manage Assertions
    • Variant Transcripts
    • Add Variant
  • Resources and References
    • Glossary
    • APIs
      • Ingest Cloud Analysis Data API (Connected Insights - Cloud Only)
      • Case APIs
      • Report APIs
      • Audit Log APIs
    • Troubleshooting
      • Overview
      • Audit Log
      • Data Backup (Connected Insights - Local)
      • Software Errors and Corrective Actions
      • How To
      • Technical Assistance
    • Pricing and Usage
    • Security and Compliance
    • Release Notes
Powered by GitBook
On this page
  • Prerequisites
  • Authorization (apiKey or psToken/iasPsToken)
  • X-ILMN-Domain
  • X-ILMN-Workgroup

Was this helpful?

Export as PDF
  1. Resources and References

APIs

PreviousGlossaryNextIngest Cloud Analysis Data API (Connected Insights - Cloud Only)

Last updated 19 hours ago

Was this helpful?

Use APIs to perform the following tasks in Connected Insights:

  • Retrieve, edit, and delete case information including disease and case metadata. For more information, refer to .

  • For Connected Insights - Cloud, ingest cloud analysis data. For more information, refer to .

  • Pull report information, including PDF report drafts and case data. For more information, refer to .

Prerequisites

Before using the APIs, make sure that the following prerequisites are met:

  • Access to the Swagger site. Access this site by appending /api-docs to the Connected Insights host URL using one of following URL formats:

    • For Connected Insights - Cloud, use the URL format https://<domain>.connectedinsights.illumina.com/api-docs

    • For Connected Insights - Local, use one of the following URL formats depending on whether a fully-qualified domain name is configured:

      • If fully-qualified domain name is configured, use the URL format https://<DRAGEN server hostname>.<domain name>/api-docs

      • If fully-qualified domain name is not configured, use the URL format https://<DRAGEN server IP address>/api-docs

      For Connected Insights - Local, the URL will follow the same format as the URL used to login to Connected Insights (for example, if the login URL includes an IP address, the API URL will also include an IP address).

  • Know the following authorization values. Instructions for finding all 3 of these values are below:\

    • Authorization (apiKey or psToken/iasPsToken)\

    • X-ILMN-Domain\

    • X-ILMN-Workgroup \

Authorization (apiKey or psToken/iasPsToken)

An API key or psToken/iasPsToken may be used. Consider the following before proceeding:

❗ Note the limitations below for API keys for Connected Insights - Cloud only:

  • Regenerating an API key will break Data Uploaders using it until API key in the uploader config file is updated.

  • If using the maximum number of API keys, consider using the psToken instead of regenerating an API key or deleting then creating a new API key.

  • If using a global API key, API actions will be limited to the workgroup used for the X-ILMN-Workgroup authorization.

If using an API key, it is retrieved from the Manage API Keys section of Connected Insights. Retrieve the API key as follows.

  1. From anywhere in Connected Insights, click your username in the top-right, then select Manage API Keys.

  2. Click Generate, enter an API key name, then select workgroups and application roles.

    Selecting All current and future workgroups and roles (Global API Key) will still cause API actions to only occur in the workgroup for the X-ILMN-Workgroup authorization you provide later in Swagger. Selecting this option does not mean all API actions will occur in all workgroups.

    You may use an existing API Key if you recorded it and it pertains to the desired workgroup(s) and application role(s). For Connected Insights - Cloud users, consider the limitations above before regenerating an existing API Key.

  3. Click Generate and copy the API key.

    This is the one time this value can be viewed. If you will use it again in the future, record and store the API key securely and do not share it with others. You cannot recover it later.

  4. In another tab or window, go to the Swagger site. Select Authorize, then in the Available authorizations window, type ApiKey (including one space after) as a prefix followed by the API key value (for example, ApiKey <API key value>)

  5. Select Authorize.

If using a psToken, it is retrieved from browser metadata where Connected Insights is being accessed:

  1. In Connected Insights browser window, right-click and select Inspect.

  2. From the Inspect pane, navigate to the top toolbar and select Application.

  3. In the Storage section, select Cookies, then select the menu option with the same name as the Connected Insights URL.

  4. In the Name column, copy one of the following values depending on whether you are using Connected Insights - Cloud or Local:

    • For Connected Insights - Cloud, select psToken and copy the psToken value that displays at the bottom of the pane.

    • For Connected Insights - Local, select iasPsToken and copy the iasPsToken value that displays at the bottom of the pane.

  5. In another tab or window, go to the Swagger site. Select Authorize, then in the Available authorizations window, paste the psToken or iasPsToken value in the Authorization (apiKey) section Value field. No prefix is required before the psToken or iasPsToken value.

  6. Select Authorize. \

X-ILMN-Domain

The domain name is retrieved from the URL.

For Connected Insights - Cloud, retrieve the domain name as follows:

  1. Copy the domain name from the URL for Connected Insights. For example, <domain> from https://<domain>.connectedinsights.illumina.com. Note that only the domain name is needed, not the entire URL.

  2. In the Swagger Available authorizations window, enter the domain name into the X-ILMN-Domain (apiKey) section Value field.

  3. Select Authorize.

For Connected Insights - Local, retrieve the domain name as follows:

  1. From the Connected Insights URL, the following information from one of the Connected Insights URLs depending on whether a fully-qualified domain name is cofigured or not:

    • Copy the DRAGEN server v4 hostname if fully qualified Domain Name is configured. For example, <DRAGEN server v4 hostanme> from https://<DRAGEN server v4 hostname>.<domain name>/. Note that only the hostname is needed, not the entire URL

    • Copy the IP address of the DRAGEN server v4 if the fully-qualified Domain name is not configured. For example, <DRAGEN server v4 IP address> from https://<DRAGEN server v4 IP address>/.

  2. In the Swagger Available authorizations window, paste the copied hostname or IP into the X-ILMN-Domain (apiKey) section Value field.

  3. Select Authorize.

X-ILMN-Workgroup

The workgroup ID is found in the metadata of the Connected Insights browser. Retrieve the workgroup ID as follows.

  1. In Connected Insights, right-click and select Inspect

  2. On the Inspect pane at the right of the screen, navigate to the top ribbon and select Application. A pane opens to the left of the Inspect pane.

  3. Navigate to the Storage section and select Cookies.

  4. From the Name column, select olympia-current-workgroup and copy the Cookie Value that displays at the bottom of the pane (for example, a1bc2efg-h3i4-567j-8901-k23l45mno6p7).

  5. In the Swagger Available authorizations window, paste the copied workgroup ID into the X-ILMN-Workgroup (apiKey) section Value field.

  6. Select Authorize.

Case APIs
Ingest Cloud Analysis Data API (ConnectedInsights - Cloud Only)
Report APIs