Skip to main content

Chat (demo mode)

Mounted only when VIGIL_DEMO_MODE=1. Retires once Agent Studio covers it.

These routes exist only while VIGIL_DEMO_MODE=1 is set on the service. They are not part of the product surface and will be removed once Agent Studio covers them.

MethodPathScopeSummary
POST/chat/{agent_id}reviewGoverned Chat
GET/chat/{agent_id}/inforeviewGet Chat Agent Info

Try it

code=$(curl -s -o /dev/null -w "%{http_code}" "$VIGIL_URL/chat/docs-api/info") # no key: every non-public route is 401
test "$code" = "401" && echo "chat routes are gated ($code)"

Routes

POST /chat/{agent_id}

Governed Chat. Scope: review.

ParameterInRequiredTypeNotes
agent_idpathyesstring

Request body:

{
"message": "string",
"history": [
{
"role": "string",
"content": "string"
}
],
"dti": 0
}
FieldTypeRequiredNotes
messagestringyes
historyarray of ChatMessageno
dtinumber | nullno

Response 200:

{
"response": "string",
"gate_status": "string",
"bii": 0,
"composite_trust": 0,
"reason": "string",
"requires_human_review": true,
"event_id": 0,
"agent_name": "string",
"agent_domain": "string",
"agent_risk": "string"
}

GET /chat/{agent_id}/info

Get Chat Agent Info. Scope: review.

Agent info for the chat UI.

ParameterInRequiredTypeNotes
agent_idpathyesstring

Response 200:

"any"

Generated from openapi.json (VIGIL 0.2.0). Scopes follow the router dependencies in VIGIL_SPEC.md section 4.2.