Chat

Query a Peer’s representation using natural language. Performs agentic search and reasoning to comprehensively answer the query based on all latent knowledge gathered about the peer from their messages and conclusions.

POST /v3/workspaces/{workspace_id}/peers/{peer_id}/chat

Chat

cURL

curl --request POST \
  --url https://api.honcho.dev/v3/workspaces/{workspace_id}/peers/{peer_id}/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "session_id": "<string>",
  "filters": {},
  "scope": "<string>",
  "target": "<string>",
  "stream": false,
  "reasoning_level": "low",
  "response_format": {}
}
'

200

{
  "content": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace_id · string · required

peer_id · string · required

Body

application/json

query · string · required

Dialectic API Prompt

Required string length: 1 - 10000

session_id · string | null

ID of the session to scope the representation to

filters · Filters · object | null

Optional filters to scope recall. This endpoint supports only the 'session_id' key: a session id, a list of session ids, or {"in": [...]}. Recall (conclusions and messages) is restricted to the allowlist; unsupported keys are rejected. When session_id is also set, it must be included in the allowlist.

scope · string string[]

Optional (unprefixed) scope name(s) to confine recall. A single scope answers from the scope's own representation of the target peer: conclusion recall is confined to what the scope observed and message recall to the scope's member sessions. A list of scopes restricts recall to the union of the scopes' member sessions (explicit allowlist, fail-closed: an empty union recalls nothing). Mutually exclusive with filters and session_id. Requires a workspace- or admin-level key.

target · string | null

Optional peer to get the representation for, from the perspective of this peer

stream · boolean · default: false

reasoning_level · enum<string> · default: low

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

Available options: minimal, low, medium, high, max

response_format · Response Format · object | null

Optional JSON Schema (root type 'object') the response must conform to. When provided, content is a JSON string matching this schema. Only a conservative subset of JSON Schema is supported; unsupported schemas are rejected with 422. Constraint keywords (minItems, maxLength, ...) are hints to the model, not enforced server-side.

Response

200

application/json

Successful Response

content · string | null · required