16 available actions
What your AI agent can do in Honcho
Honcho provides memory, context, and theory-of-mind infrastructure for building stateful AI agents. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 16 actions.
Common starting points
- Get MessageReturn one message by its exact ID within a session.
- Get or Create PeerReturn a peer by ID within a workspace, creating it with the supplied metadata and configuration when absent.
- Create ConclusionsStore a batch of 1-100 explicit conclusions about peers, optionally tied to sessions.
- Create MessagesAdd a batch of 1-100 attributed messages to a Honcho session.
- Delete SessionPermanently delete one known session and its session-scoped data.
- Chat With PeerRun usage-bearing agentic search and reasoning over a peer's learned representation to answer a question.
Browse all 16 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 12 actions
- Get MessageReturn one message by its exact ID within a session.
- Get or Create PeerReturn a peer by ID within a workspace, creating it with the supplied metadata and configuration when absent.
- Get or Create SessionReturn a session by ID, or create it with initial peers, metadata, and configuration when absent.
- Get or Create WorkspaceReturn a workspace by ID, or create it with metadata and configuration when absent.
- Get Peer RepresentationReturn a curated subset of conclusions representing a peer.
- List ConclusionsReturn one page of stored conclusions in a workspace; use Search Conclusions for semantic retrieval.
- List MessagesReturn one page of messages in a session; use Get Message for exact-ID retrieval.
- List PeersReturn one page of peers in a workspace.
- List SessionsReturn one page of sessions in a workspace.
- List WorkspacesReturn one page of Honcho workspaces visible to the connected admin key.
- Search ConclusionsSemantically search stored conclusions in a workspace.
- Search MessagesSemantically search messages at workspace, peer, or session scope.
Create & communicateCreate records or send supported messagesView 2 actions
- Create ConclusionsStore a batch of 1-100 explicit conclusions about peers, optionally tied to sessions.
- Create MessagesAdd a batch of 1-100 attributed messages to a Honcho session.
Remove & cancelRemove records or cancel supported workView 1 action
- Delete SessionPermanently delete one known session and its session-scoped data.
Other actionsSpecialist and administrative actions.View 1 action
- Chat With PeerRun usage-bearing agentic search and reasoning over a peer's learned representation to answer a question.
Connection record
A connection you can control.
- Sign-in
- Customer-managed key
- Setup
- Use a key you create and control. It is stored securely and limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Honcho
How does the agent connect to Honcho?
With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.
What can the agent actually do in Honcho?
The page above lists the 16 actions currently available through the Honcho connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Honcho included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Honcho is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Honcho to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.