Agent API Reference
REST API for AI agents and non-MCP frameworks to search the knowledge base, read the FAQ, manage tickets, and generate grounded answers.
The Agent API is a REST surface for AI agents and non-MCP frameworks
(LangChain, AutoGen, custom bots) to search a knowledge base, read the
latest FAQ, list/create tickets, and generate grounded answers — the same
pipeline every other AnswerLoops channel uses. MCP-native clients (Claude
Code, Cursor) should use the MCP server at POST /api/mcp instead; this
REST surface exists for tooling that speaks HTTP + OpenAPI, not JSON-RPC.
Every request is authenticated with an org-scoped API key generated in
Settings → API Keys (al_live_ prefix), sent as a bearer token. The
same key authenticates both this REST surface and the MCP server.
This reference is generated directly from the live OpenAPI spec at
/api/agent/openapi.json — every endpoint
below actually exists and works.
Search the knowledge base
Semantically search the organization's knowledge base
Get the latest FAQ
Read the auto-generated FAQ for the organization
List tickets
List support tickets, optionally filtered by status
Create a ticket
File a new support ticket
Generate an answer
Run the confidence-gated answer pipeline against a question