ReferenceAgent API
Generate a grounded answer using the organization's knowledge base, without opening a ticket
Counts against the org's monthly deflection limit — if the limit is reached, returns 429 instead of generating for free. Only high-confidence generations count toward that limit.
Authorization
bearerAuth AuthorizationBearer <token>
Org-scoped API key generated in Settings → API Keys (al_live_ prefix). Shared with the MCP server — the same key authenticates both surfaces.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/agent/answers" \ -H "Content-Type: application/json" \ -d '{ "question": "string" }'{ "answer": "string", "confidence": 0, "answered_fully": true, "high_confidence": true}{ "error": { "message": "string" }}{ "error": { "message": "string" }}{ "error": { "message": "string" }}