v1

latestOpenAPI 3.1.0BUSL-1.12026-07-1756132288.0 KB

Phase 7.5 — Spectron-as-agent chat endpoint. Stores the user message via /facts, retrieves context via the unified /query router, calls the configured LLM provider, stores the assistant response via /facts, and emits a response_trace. Set stream=true for SSE.

post/api/v1/{context_id}/chat

Path parameters

context_idstring required

Spectron context id

Request body

bypassCacheboolean

Phase 7.6 — when true skips the tier-2 response cache and forces a fresh tier-3 call. Defaults to false.

labelsstring[]

Descriptive labels for rows the chat persists.

messagestring required
modelstring nullable
sessionIdstring nullable
streamboolean

Response

replystring required
sessionIdstring required
traceIdstring required