API Access Keys Management

API Access Keys allow external systems to access the Luma Virtual Agent platform with proper identification and authorization. 

To create a new API Access Keys,

  1. Navigate to Tenant menu → Settings → API Access Keys 

  2. Click Create API Key

  3. Enter the name for the new Key.

  4. Select the Status for the Key. When a Key is set to Inactive, access from external systems will be denied.

  5. Click Next.

  6. Provide the required permissions on the Permissions page.

  7. Click Create.

  8. Copy the API Access Key for future use.

The API Access Key is displayed only one time, at the time of creation. Once the popup window is closed, the key is never shown again on the user interface. Make sure that you copy and store it securely, to be used in the 3rd party applications. 

Using the API Access Key in the API Request Header

You need to pass the below details as Header Fields in the API Request.

  1. Tenant External ID: It helps identify the tenant in the Virtual Agent Platform which can be retrieved from the Tenant Information page in the Settings menu. 

  2. API Access Key:  It helps to identify and authorize the external application.