v1

latestOpenAPI 3.1.0GNU Affero General Public License v3.0raw.githubusercontent.com2026-05-074555150.3 KB

sessions

Get Session Context

Produce a context object from the Session. The caller provides an optional token limit which the entire context must fit into. If not provided, the context will be exhaustive (within configured max tokens). To do this, we allocate 40% of the token limit to the summary, and 60% to recent messages -- as many as can fit. Note that the summary will usually take up less space than this. If the caller does not want a summary, we allocate all the tokens to recent messages.

get/v3/workspaces/{workspace_id}/sessions/{session_id}/context

Path parameters

workspace_idstring required

session_idstring required

Query parameters

tokensinteger nullable

Number of tokens to use for the context. Includes summary if set to true. Includes representation and peer card if they are included in the response. If not provided, the context will be exhaustive (within 100000 tokens)

Number of tokens to use for the context. Includes summary if set to true. Includes representation and peer card if they are included in the response. If not provided, the context will be exhaustive (within 100000 tokens)

search_querystring nullable

A query string used to fetch semantically relevant conclusions

A query string used to fetch semantically relevant conclusions

summaryboolean

Whether or not to include a summary if one is available for the session

Whether or not to include a summary if one is available for the session

peer_targetstring nullable

The target of the perspective. If given without peer_perspective, will get the Honcho-level representation and peer card for this peer. If given with peer_perspective, will get the representation and card for this peer from the perspective of that peer.

The target of the perspective. If given without peer_perspective, will get the Honcho-level representation and peer card for this peer. If given with peer_perspective, will get the representation and card for this peer from the perspective of that peer.

peer_perspectivestring nullable

A peer to get context for. If given, response will attempt to include representation and card from the perspective of that peer. Must be provided with peer_target.

A peer to get context for. If given, response will attempt to include representation and card from the perspective of that peer. Must be provided with peer_target.

limit_to_sessionboolean

Only used if search_query is provided. Whether to limit the representation to the session (as opposed to everything known about the target peer)

Only used if search_query is provided. Whether to limit the representation to the session (as opposed to everything known about the target peer)

search_top_kinteger nullable

Only used if search_query is provided. The number of semantic-search-retrieved conclusions to include in the representation

Only used if search_query is provided. The number of semantic-search-retrieved conclusions to include in the representation

search_max_distancenumber nullable

Only used if search_query is provided. The maximum distance to search for semantically relevant conclusions

Only used if search_query is provided. The maximum distance to search for semantically relevant conclusions

include_most_frequentboolean

Only used if search_query is provided. Whether to include the most frequent conclusions in the representation

Only used if search_query is provided. Whether to include the most frequent conclusions in the representation

max_conclusionsinteger nullable

Only used if search_query is provided. The maximum number of conclusions to include in the representation

Only used if search_query is provided. The maximum number of conclusions to include in the representation

Response

Successful Response

idstring required

peer_representationstring nullable

A curated subset of a peer representation, if context is requested from a specific perspective

peer_cardstring[] nullable

The peer card, if context is requested from a specific perspective