workspaces

Query the entire workspace using natural language. Runs the Dialectic agent over every peer in the workspace rather than a single (observer, observed) pair: there is no anchor peer and no target.

Pass session_id to narrow message tools to one session, or scope to restrict recall to the union of the named scopes' member sessions (always an allowlist, even for a single name; a scope with no member sessions recalls nothing). session_id and scope are mutually exclusive.

Set stream: true to receive the answer as a text/event-stream of {"delta": {"content": ...}, "done": false} chunks terminated by {"done": true}. Requires a workspace- or admin-level key.

post/v3/workspaces/{workspace_id}/chat

Request

  • Base URL
    https://api.honcho.dev
  • Auth
    HTTP bearer

Path parameters

workspace_idstring required

Request body

session_idstring nullable

Optional session to scope message tools to

querystring required

Workspace chat prompt

streamboolean

Return the answer as a text/event-stream. The answer arrives when the agent finishes gathering context, usually as a single chunk; only an answer synthesized at the tool-call limit streams as it is generated.

reasoning_level'minimal' | 'low' | 'medium' | 'high' | 'max'

Level of reasoning to apply: minimal, low, medium, high, or max

response_formatobject nullable

Optional JSON Schema (root type 'object') the response must conform to. When provided, content is a JSON string matching this schema.

include_evidenceboolean

When true, the response includes an evidence object listing the conclusions and messages the agent read while answering, plus the tool calls it made. Evidence is collated from what the agent accessed; the model is never asked to cite anything, so evidence may over-report (accessed is not the same as used).

Response

Successful Response

contentstring nullable required

Changes

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status