Sign in

Phase 7.5 — Spectron-as-agent chat endpoint. Resolves the session, retrieves context via the unified /query router, and calls the configured LLM provider; then, only after a successful synthesis (or a tier-2 cache hit), stores the user message and the assistant response via /facts and emits a response_trace. A failed synthesis writes no turn, fact, or response_trace (a retrieval_trace recording the query may still be written). 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
suppressMarkersboolean

When true, the reply text carries no inline citation marker in either form ([S1] or bare S1); citations still names every source the reply cited before the markers were removed. Defaults to false.

Response

replystring required
sessionIdstring required
traceIdstring required

Changes

Changed in 3 of the 5 revisions of this API.26

  • 9f15987130674See the full diff
    • ○

      added the new optional request property suppressMarkers

      new-optional-request-property

    • ○

      added the non-success response with the status 503

      response-non-success-status-added

    • ○

      added the required property citations to the response with the 200 status

      response-required-property-added

    • ○

      added the required property memoryUpdates/actions to the response with the 200 status

      response-required-property-added

  • 6ad06b1fefc411See the full diff
    • ●

      removed the request property scope

      request-property-removed

    • ○

      added the new optional request property scopes

      new-optional-request-property

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 741d58b9ef8911See the full diff
    • ●

      removed the request property scopes

      request-property-removed

    • ○

      added the new optional request property scope

      new-optional-request-property

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog