> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Honcho

> Honcho provides memory, context, and theory-of-mind infrastructure for building stateful AI agents.

![Honcho logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/honcho.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=59f9d0b0fcd78384fb54b96fcb4a4048)

* **Category:** artificial intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 16
* **Triggers:** 0
* **Slug:** `HONCHO`
* **Version:** 20261101\_00

## Tools

> [accordion] Chat With Peer
>
> **Slug:** `HONCHO_CHAT_WITH_PEER`
>
> Run usage-bearing agentic search and reasoning over a peer's learned representation to answer a question. Higher reasoning levels generally cost more and take longer. Returns one non-streaming JSON response.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Question or reasoning prompt for the peer, from 1 to 10,000 characters.
>
> **target** `string`
>
> Optional target peer to reason about from the selected peer's perspective.
>
> **peer\_id** `string` *required*
>
> Peer whose learned representation should answer.
>
> **session\_id** `string`
>
> Optional session that scopes the representation used to answer.
>
> **workspace\_id** `string` *required*
>
> Workspace containing the peer.
>
> **reasoning\_level** `string ("minimal" | "low" | "medium" | "high" | "max")`
>
> Reasoning effort. Prefer minimal or low unless deeper synthesis is needed; higher levels may increase usage cost and latency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Conclusions
>
> **Slug:** `HONCHO_CREATE_CONCLUSIONS`
>
> Store a batch of 1-100 explicit conclusions about peers, optionally tied to sessions.
>
> #### Input Parameters
>
> **conclusions** `array` *required*
>
> One to 100 explicit conclusions to store.
>
> **workspace\_id** `string` *required*
>
> Workspace in which to store the conclusions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Messages
>
> **Slug:** `HONCHO_CREATE_MESSAGES`
>
> Add a batch of 1-100 attributed messages to a Honcho session. Message-level reasoning settings can trigger usage-bearing processing.
>
> #### Input Parameters
>
> **messages** `array` *required*
>
> One to 100 attributed messages to add to the session.
>
> **session\_id** `string` *required*
>
> Session receiving the messages.
>
> **workspace\_id** `string` *required*
>
> Workspace containing the session.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Session
>
> **Slug:** `HONCHO_DELETE_SESSION`
>
> Permanently delete one known session and its session-scoped data. Honcho marks the session inactive immediately and completes deletion asynchronously.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Session to delete permanently.
>
> **workspace\_id** `string` *required*
>
> Workspace containing the session.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Message
>
> **Slug:** `HONCHO_GET_MESSAGE`
>
> Return one message by its exact ID within a session.
>
> #### Input Parameters
>
> **message\_id** `string` *required*
>
> Opaque message ID returned by create or list messages.
>
> **session\_id** `string` *required*
>
> Session containing the message.
>
> **workspace\_id** `string` *required*
>
> Workspace containing the session.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get or Create Peer
>
> **Slug:** `HONCHO_GET_OR_CREATE_PEER`
>
> Return a peer by ID within a workspace, creating it with the supplied metadata and configuration when absent. Existing peers are returned unchanged.
>
> #### Input Parameters
>
> **peer\_id** `string` *required*
>
> Stable peer ID containing only letters, digits, underscores, or hyphens.
>
> **metadata** `object`
>
> Arbitrary JSON metadata applied only when the peer is created.
>
> **workspace\_id** `string` *required*
>
> Workspace that owns the peer.
>
> **configuration** `object`
>
> Optional peer configuration applied only when the peer is created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get or Create Session
>
> **Slug:** `HONCHO_GET_OR_CREATE_SESSION`
>
> Return a session by ID, or create it with initial peers, metadata, and configuration when absent. Creation may create missing peers and start usage-bearing processing when reasoning features are enabled; existing sessions remain unchanged.
>
> #### Input Parameters
>
> **peers** `object`
>
> Initial membership keyed by peer ID. Missing peers may be created by Honcho.
>
> **metadata** `object`
>
> Arbitrary JSON metadata applied only when the session is created.
>
> **session\_id** `string` *required*
>
> Stable session ID containing only letters, digits, underscores, or hyphens.
>
> **workspace\_id** `string` *required*
>
> Workspace that owns the session.
>
> **configuration** `object`
>
> Optional creation-time reasoning, summary, dream, and peer-card settings. Enabling these features can start usage-bearing background processing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get or Create Workspace
>
> **Slug:** `HONCHO_GET_OR_CREATE_WORKSPACE`
>
> Return a workspace by ID, or create it with metadata and configuration when absent. Enabling reasoning features during creation may start usage-bearing background processing.
>
> #### Input Parameters
>
> **metadata** `object`
>
> Arbitrary JSON metadata applied only when the workspace is created.
>
> **workspace\_id** `string` *required*
>
> Stable workspace ID containing only letters, digits, underscores, or hyphens.
>
> **configuration** `object`
>
> Optional creation-time reasoning, summary, dream, and peer-card settings. Enabling these features can start usage-bearing background processing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Peer Representation
>
> **Slug:** `HONCHO_GET_PEER_REPRESENTATION`
>
> Return a curated subset of conclusions representing a peer. Supplying search\_query performs semantic retrieval and may consume paid search capacity; omit it for the existing default representation.
>
> #### Input Parameters
>
> **target** `string`
>
> Optional target peer represented from the selected peer's perspective.
>
> **peer\_id** `string` *required*
>
> Peer whose representation to retrieve.
>
> **session\_id** `string`
>
> Optional session within which to scope the representation.
>
> **search\_query** `string`
>
> Optional semantic query used to curate conclusions. Supplying it may consume paid search capacity.
>
> **search\_top\_k** `integer`
>
> With search\_query, retrieve up to this many semantic matches (1-100).
>
> **workspace\_id** `string` *required*
>
> Workspace containing the peer.
>
> **max\_conclusions** `integer`
>
> Maximum conclusions to include in the representation (1-100).
>
> **search\_max\_distance** `number`
>
> With search\_query, use this maximum cosine distance from 0 to 1.
>
> **include\_most\_frequent** `boolean`
>
> With search\_query, also include frequently recurring conclusions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Conclusions
>
> **Slug:** `HONCHO_LIST_CONCLUSIONS`
>
> Return one page of stored conclusions in a workspace; use Search Conclusions for semantic retrieval.
>
> #### Input Parameters
>
> **size** `integer`
>
> Maximum conclusions in this page (1-100).
>
> **reverse** `boolean`
>
> Return results in reverse provider order.
>
> **next\_cursor** `string`
>
> Continuation value from a previous call; omit for the first page.
>
> **workspace\_id** `string` *required*
>
> Workspace whose conclusions to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Messages
>
> **Slug:** `HONCHO_LIST_MESSAGES`
>
> Return one page of messages in a session; use Get Message for exact-ID retrieval.
>
> #### Input Parameters
>
> **size** `integer`
>
> Maximum messages in this page (1-100).
>
> **reverse** `boolean`
>
> Return results in reverse provider order.
>
> **session\_id** `string` *required*
>
> Session whose messages to list.
>
> **next\_cursor** `string`
>
> Continuation value from a previous call; omit for the first page.
>
> **workspace\_id** `string` *required*
>
> Workspace containing the session.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Peers
>
> **Slug:** `HONCHO_LIST_PEERS`
>
> Return one page of peers in a workspace.
>
> #### Input Parameters
>
> **size** `integer`
>
> Maximum peers in this page (1-100).
>
> **reverse** `boolean`
>
> Return results in reverse provider order.
>
> **next\_cursor** `string`
>
> Continuation value from a previous call; omit for the first page.
>
> **workspace\_id** `string` *required*
>
> Workspace whose peers to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sessions
>
> **Slug:** `HONCHO_LIST_SESSIONS`
>
> Return one page of sessions in a workspace.
>
> #### Input Parameters
>
> **size** `integer`
>
> Maximum sessions in this page (1-100).
>
> **reverse** `boolean`
>
> Return results in reverse provider order.
>
> **next\_cursor** `string`
>
> Continuation value from a previous call; omit for the first page.
>
> **workspace\_id** `string` *required*
>
> Workspace whose sessions to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workspaces
>
> **Slug:** `HONCHO_LIST_WORKSPACES`
>
> Return one page of Honcho workspaces visible to the connected admin key.
>
> #### Input Parameters
>
> **size** `integer`
>
> Maximum workspaces in this page (1-100).
>
> **reverse** `boolean`
>
> Return results in reverse provider order.
>
> **next\_cursor** `string`
>
> Opaque continuation value returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Conclusions
>
> **Slug:** `HONCHO_SEARCH_CONCLUSIONS`
>
> Semantically search stored conclusions in a workspace from a specified observer peer's perspective about a specified observed peer. This operation may consume paid search or embedding capacity.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Natural-language semantic query.
>
> **top\_k** `integer`
>
> Maximum semantic matches to return (1-100).
>
> **observed\_id** `string` *required*
>
> ID of the peer the matching conclusions must be about.
>
> **observer\_id** `string` *required*
>
> ID of the peer whose perspective the conclusions were recorded from.
>
> **max\_distance** `number`
>
> Optional maximum cosine distance from 0 to 1; lower values require closer matches.
>
> **workspace\_id** `string` *required*
>
> Workspace whose conclusions to search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Messages
>
> **Slug:** `HONCHO_SEARCH_MESSAGES`
>
> Semantically search messages at workspace, peer, or session scope. WARNING: this operation may consume paid search or embedding capacity; use list or get message tools for exact or chronological retrieval.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum matching messages to return (1-100).
>
> **query** `string` *required*
>
> Natural-language semantic search query.
>
> **scope** `string ("workspace" | "peer" | "session")` *required*
>
> Boundary for the semantic search: workspace, peer, or session.
>
> **peer\_id** `string`
>
> Peer to search. Required only when scope is peer; otherwise omit it.
>
> **session\_id** `string`
>
> Session to search. Required only when scope is session; otherwise omit it.
>
> **workspace\_id** `string` *required*
>
> Workspace to search within.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
