Honcho Memory API
Conversational memory for AI agents
Give your agents persistent memory. Store conversation history, and let Honcho automatically build rich representations of users and context over time. Pay per request — no auth, no subscriptions.
Each wallet gets its own workspace, auto-provisioned on first use. Agents identify as peers within a workspace and interact through sessions. Honcho derives insights, summaries, and peer cards in the background.
Install Honcho Memory into AgentCash.
Run in your terminal
Onboard into AgentCash, make one live call against this API, then save it into your agent's persistent context.
Onboard AgentCash
Sets up AgentCash and routes you through credits if needed.
npx agentcash onboardTry the API
Discovers the origin and walks the first live call path.
npx agentcash try https://agentcash.honcho.devAdd for reuse
Keeps Honcho Memory available in your agent's persistent context.
npx agentcash add https://agentcash.honcho.devagentcash.honcho.devEndpoints
Messages
$0.001+ / 1M tokensStore messages in a session. Auto-provisions workspace, peers, and session on first use. Each message specifies its author peer. Priced at $2 per million tokens of message content (~4 chars/token), with a $0.001 minimum per call.
POST /api/honcho/messagesChat
$0.001–$0.50Query a peer's memory with a natural language question. Returns what Honcho has learned from stored conversations. Price varies by reasoning_level.
POST /api/honcho/chatRepresentation
FreeGet a markdown summary of what Honcho has learned about a peer from conversation history. Free with SIWX wallet auth.
POST /api/honcho/representationCard
FreeGet key facts about a peer, maintained automatically by Honcho as conversations progress. Free with SIWX wallet auth.
POST /api/honcho/cardContext
FreeGet session context for LLM consumption — recent messages, optional summary, and peer representation. Free with SIWX wallet auth.
POST /api/honcho/contextPeers
FreeList all peers in a workspace with their metadata and creation timestamps. Free with SIWX wallet auth.
POST /api/honcho/peersSessions
FreeList sessions in the workspace, paginated.
POST /api/honcho/sessionsList Messages
FreeList messages in a session, paginated and ordered by creation time.
POST /api/honcho/messages/listSession Peers
FreeList peers participating in a session.
POST /api/honcho/sessions/peersAdd Session Peers
FreeAdd peers to a session. Auto-provisions peers and the session on first use.
POST /api/honcho/sessions/peers/addRemove Session Peers
FreeRemove peers from a session.
POST /api/honcho/sessions/peers/removeDelete Session
FreePermanently delete a session and all of its messages.
POST /api/honcho/sessions/deleteSession Summaries
FreeShort and long summaries Honcho has generated for a session.
POST /api/honcho/sessions/summariesSearch
FreeSemantic search over messages. Defaults to the whole workspace; pass session or peer to scope it.
POST /api/honcho/searchSet Card
FreeReplace a peer's card (or this peer's card about a target) with a new array of facts.
POST /api/honcho/card/setPeer Sessions
FreeList the sessions a specific peer participates in, paginated.
POST /api/honcho/peers/sessions