Skip to main content
POST
Peer Chat

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

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.

include_evidence
boolean
default:false

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

content
string | null
required
evidence
Evidence · object | null

What the answer was built from. Present only when include_evidence is true.