API Reference

API Reference

WAI Docs Wed Aug 19 13:22:37 EDT 2026
List
Quick Start
Welcome
Supported Applications & LLMs
Release Notes
August 18, 2026 WitnessAI Release
August 4, 2026 WitnessAI Release
July 21, 2026 WitnessAI Release
July 14, 2026 WitnessAI Release
July 9, 2026 WitnessAI Release
June 30, 2026 WitnessAI Hotfix
June 23, 2026 WitnessAI Release
June 16, 2026 WitnessAI Release
June 11, 2026 WitnessAI Release
June 4, 2026 WitnessAI Hotfix
June 2, 2026 WitnessAI Update
May 19, 2026 WitnessAI Update
April 30, 2026 WitnessAI Update
April 28, 2026 WitnessAI Update
April 23, 2026 WitnessAI Update
April 16, 2026 WitnessAI Update
April 14, 2026 WitnessAI Update
April 9, 2026 WitnessAI Update
April 9, 2026 WitnessAI Update
April 7, 2026 WitnessAI Update
April 2, 2026 WitnessAI Update
March 31, 2026 WitnessAI Update
March 24, 2026 WitnessAI Update
March 19, 2026 WitnessAI Update
March 17, 2026 WitnessAI Update
March 12, 2026 WitnessAI Update
March 5, 2026 WitnessAI Update
February 26, 2026 WitnessAI Update
February 24, 2026 WitnessAI Update
February 10, 2026 WitnessAI Update
January 27, 2026 WitnessAI Update
January 20, 2026 WitnessAI Update
January 13, 2026 WitnessAI Update
December 18, 2025 WitnessAI Update
December 9, 2025 WitnessAI Update
November 25, 2025 WitnessAI Update
November 18, 2025 WitnessAI Update
November 11, 2025 WitnessAI Update
October 28, 2025 WitnessAI Update
October 23, 2025 WitnessAI Update
October 9, 2025 WitnessAI Update
October 2, 2025 WitnessAI Update
September 30, 2025: WitnessAI Update
September 23, 2025: WitnessAI Update
August 12, 2025: WitnessAI Update
July 31, 2025: WitnessAI Update
July 18, 2025: WitnessAI Update
April 11, 2025: WitnessAI Release v2.0
June 9, 2025: WitnessAI Update
June 23, 2025: WitnessAI Update
TOC Left Sidebar: not active
TOC Left Sidebar: ORIGINAL
User Guide
Policies - GuardRails
Witness Anywhere: Remote Device Security
Witness Attack
Administrator Guide
404

WitnessAI API Overview

WitnessAI provides four APIs, giving your Custom Applications the ability to apply your Policy and Guardrail protections as a single API request, or in a step-by-step manner, with granular control over the process.
WitnessAI API architecture diagram showing the data flow between ‘Your Custom App’ (blue, left), ‘WitnessAI’ (orange, center), and ‘Destination AI/LLM’ (purple, right). Input API shows Risky Prompt (red arrow) and Safe Response (green arrow). Text-Completion API shows Safe Prompt (green) and Risky Response (red). Complete API label at the bottom.
These three APIs provide granular control:
The “Input” API submits an Unprocessed Prompt to WitnessAI.
  • The Unprocessed Prompt is not forwarded from WitnessAI to the Destination App or LLM. (collectively “Apps”).
  • WitnessAI processes the Risky Prompt in the same way it does for any of the AI Apps we support.
  • WitnessAI responds to the input API request with a Safe Prompt, plus an array of “Scorecards” providing detailed information on intention classification, risk scores, redaction tokens, and output of all Policies and Guardrails that match the sources, prompt data, and destinations of the input request.
 
The “Text-Completion” API instructs WitnessAI to submit the Safe Prompt to the Destination App.
  • The Safe Prompt is processed by WitnessAI, and forwarded to the Destination App.
 
The “Complete”API is used to process the response of the Destination App to the Safe Prompt WitnessAI submitted to the Destination App.
  • The Destination App responds to the Safe Prompt, and WitnessAI processes the response through your Response Policies and Guardrails, for example the “Harmful Response” Guardrail.
  • WitnessAI returns the Safe Response back to your Custom App that submitted the input API request.
 
“Prompt-Protect” is the forth API.
  • “Prompt-Protect” completes the three steps above with a single API request, without interruption.

Interactive Testing

WitnessAI APIs can be tested interactively at: witnessapi.readme.io.
The password is: akuCR9jUKnZ42ojnCrcxpok#
When you login to the API site, a cookie is set in your browser that keeps you logged in for seven days.

Full API Documentation

Input API

Text-Completion API

Complete API

Prompt-Protect API