Private Applications

Private Applications enable your custom AI applications to have all of the visibility, control, and protection of WitnessAI. Just use the WitnessAI APIs to submit the application’s LLM prompts, and receive the LLM responses.

Setting Up a Private Application

Step 1: Create API Key(s)

You can review the WitnessAI Documentation for API Keys here.

Navigate to Settings from the main menu.

Click API Keys.

Enter a description for your key (e.g., "Finance AI").

Set an expiration date for the key.

Click Generate.

Use the “Copy” icon to copy your new API key to your clipboard.

A popup message will appear stating the key has been copied to your clipboard

Image of pop up message stating “Successfully copied to clipboard”

Step 2: Use the API in Your Application

You can review the WitnessAI API Reference Documentation here.

The “Input” and “Prompt-Protect” API calls are the APIs that initiate the sequence of submitting a prompt to WitnessAI. In these APIs there is an object named caller, containing an application_name field. The application name ties together all of your conversations for that custom application.

Input API excerpt.


Object: caller
	Field: application_name Type: string Example: “My Custom App”
			Description: Application name as displayed in the console.
	Field: application_version Type: string Example: 1.0.1
			Description: Application version.

Create a unique application name to use in all of your application’s API calls to WitnessAI. All of the prompts you submit through the API, and the responses, will appear in your conversations identified by this application name.

Example: If you have a custom AI application for Finance, and use the application_name "Finance AI App", all conversations in WitnessAI will show "Finance AI App" as the application. All alerts will also show "Finance AI App" as the application, and all your policies and guardrails will now have a “Finance AI App” available as a destination.

Step 3: Add the Application to Private Apps List

Image of Witness AI “Private Applications” list.

Navigate to Lists from the main menu.

Click Private Apps.

Click Add.

Enter the API application name (e.g., "Finance AI").

Click Save.

Image of the “Add Private Application” dialog box with application name added.

Step 4: Update Policies to include your Private Application

Once your application is added to the Private Apps list, you can include it in your existing policies, and create new policies.

Image of the Witness AI “Policies” page, showing a Policy open in editing mode, with a new “Destination” added of type “Private Applications” and the “Finance AI App” entered in the “is any of these” field.

Navigate to Policies.

Select the policy you want to apply (e.g., "PII Protection").

Add your private application as a destination (e.g., "Finance AI").

Click Save.

All the prompts you submit through the API, and the responses, will now be protected by WitnessAI and available in all standard features.