# Honcho - [Honcho Overview](https://honcho.dev/docs/v3/documentation/introduction/overview.md) - [Quickstart](https://honcho.dev/docs/v3/documentation/introduction/quickstart.md) - [Agentic Development](https://honcho.dev/docs/v3/documentation/introduction/vibecoding.md): Agent skills, MCP server, and tools for building with Honcho - [Architecture & Intuition](https://honcho.dev/docs/v3/documentation/core-concepts/architecture.md): Understanding Honcho's core concepts and data model. - [Honcho Reasoning](https://honcho.dev/docs/v3/documentation/core-concepts/reasoning.md) - [Peer Representations](https://honcho.dev/docs/v3/documentation/core-concepts/representation.md) - [Design Patterns](https://honcho.dev/docs/v3/documentation/core-concepts/design-patterns.md): Design your workspace, peers, and sessions for common application patterns - [Storing Data](https://honcho.dev/docs/v3/documentation/features/storing-data.md): Store Data in Honcho to Generate Memories and Insights - [Get Context](https://honcho.dev/docs/v3/documentation/features/get-context.md): Learn how to use context() to retrieve and format conversation context for LLM integration - [Chat Endpoint](https://honcho.dev/docs/v3/documentation/features/chat.md): Ask Honcho questions about one peer, or across a whole workspace - [Advanced Features](https://honcho.dev/docs/v3/documentation/features/advanced/overview.md): Advanced configuration and monitoring options for Honcho - [Reasoning Configuration](https://honcho.dev/docs/v3/documentation/features/advanced/reasoning-configuration.md): Customize how Honcho reasons over peers, sessions, and messages - [Summarizer](https://honcho.dev/docs/v3/documentation/features/advanced/summarizer.md): How Honcho creates summaries of conversations - [Peer Card](https://honcho.dev/docs/v3/documentation/features/advanced/peer-card.md): A quick-reference profile of stable biographical facts about a peer - [Directional Representations](https://honcho.dev/docs/v3/documentation/features/advanced/directional-representations.md): How peers build and query representations of other peers - [Scopes](https://honcho.dev/docs/v3/documentation/features/advanced/scopes.md): Named sets of sessions that act as visibility boundaries for recall - [Dreaming](https://honcho.dev/docs/v3/documentation/features/advanced/dreaming.md): How Honcho continuously improves memory through autonomous consolidation - [Queue Status](https://honcho.dev/docs/v3/documentation/features/advanced/queue-status.md): Learn how to check the status of Honcho's reasoning - [Webhooks](https://honcho.dev/docs/v3/documentation/features/advanced/webhooks.md): Receive push notifications when Honcho finishes background work - [Search](https://honcho.dev/docs/v3/documentation/features/advanced/search.md): Learn how to search across workspaces, sessions, and peers to find relevant conversations and content - [Using Filters](https://honcho.dev/docs/v3/documentation/features/advanced/using-filters.md): Learn how to filter workspaces, peers, sessions, and messages using Honcho's powerful filtering system - [Structured Outputs](https://honcho.dev/docs/v3/documentation/features/advanced/structured-outputs.md): Get chat endpoint answers as typed, machine-readable JSON - [Streaming Responses](https://honcho.dev/docs/v3/documentation/features/advanced/streaming-response.md): Using streaming responses with Honcho SDKs - [File Uploads](https://honcho.dev/docs/v3/documentation/features/advanced/file-uploads.md): Upload PDFs, text files, and JSON documents to create messages in Honcho - [Deleting Data](https://honcho.dev/docs/v3/documentation/features/advanced/deleting-data.md): How to delete sessions, workspaces, and conclusions — and what survives each - [The Honcho Dashboard](https://honcho.dev/docs/v3/documentation/reference/platform.md): Build stateful agents without worrying about infrastructure - [SDK Reference](https://honcho.dev/docs/v3/documentation/reference/sdk.md): Complete SDK documentation and examples for Python and TypeScript - [CLI Reference](https://honcho.dev/docs/v3/documentation/reference/cli.md): Command-line interface for Honcho — inspect workspaces, peers, sessions, and memory from your terminal - [Guides, Cookbooks, and Integrations](https://honcho.dev/docs/v3/guides/overview.md): Helpful guides and design patterns for building with Honcho - [Claude Code](https://honcho.dev/docs/v3/guides/integrations/claude-code.md): Add AI-native memory to Claude Code - [OpenCode](https://honcho.dev/docs/v3/guides/integrations/opencode.md): Add AI-native memory to OpenCode - [Codex](https://honcho.dev/docs/v3/guides/integrations/codex.md): Add AI-native memory to OpenAI Codex - [DeepSeek Harness](https://honcho.dev/docs/v3/guides/integrations/deepseek-harness.md): Add AI-native memory to DeepSeek Harness - [Vercel AI SDK](https://honcho.dev/docs/v3/guides/integrations/vercel-ai-sdk.md): Add persistent user memory and reasoning to any Vercel AI SDK app with Honcho - [CrewAI](https://honcho.dev/docs/v3/guides/integrations/crewai.md): Build AI agents with persistent memory using CrewAI and Honcho - [LangGraph](https://honcho.dev/docs/v3/guides/integrations/langgraph.md): Build a stateful conversational AI agent with LangGraph and Honcho - [Model Context Protocol (MCP)](https://honcho.dev/docs/v3/guides/integrations/mcp.md): Give any AI tool persistent memory with the Honcho MCP server - [n8n](https://honcho.dev/docs/v3/guides/integrations/n8n.md): Connect Honcho to your n8n workflows to build intelligent automation workflows and agents that leverage persistent memory across sessions. - [OpenClaw](https://honcho.dev/docs/v3/guides/integrations/openclaw.md): Add AI-native memory to OpenClaw - [Hermes Agent + Honcho](https://honcho.dev/docs/v3/guides/integrations/hermes.md): How Hermes Agent uses Honcho for persistent cross-session memory and user modeling - [Zo Computer](https://honcho.dev/docs/v3/guides/integrations/zo-computer.md): Add persistent memory to Zo Computer skills using Honcho - [Paperclip](https://honcho.dev/docs/v3/guides/integrations/paperclip.md): Add Honcho memory to Paperclip - [SillyTavern](https://honcho.dev/docs/v3/guides/integrations/sillytavern.md): Add persistent, personalized memory to SillyTavern AI characters with Honcho - [Unified Memory Setup](https://honcho.dev/docs/v3/guides/recipes/unified-memory-setup.md): Wire one shared Honcho workspace across a chat companion, a coding agent, an autonomous agent, and a scheduled ingestion job - [Discord Bots with Honcho](https://honcho.dev/docs/v3/guides/discord.md): Use Honcho to build a Discord bot with conversational memory and context management. - [Granola](https://honcho.dev/docs/v3/guides/granola.md): Import meeting notes and transcripts from Granola into Honcho - [Telegram Bots with Honcho](https://honcho.dev/docs/v3/guides/telegram.md): Use Honcho to build a Telegram bot with conversational memory and context management. - [Voice Agent - Reachy Mini](https://honcho.dev/docs/v3/guides/integrations/reachy-mini.md): Build an embodied voice AI agent with long-term memory using Honcho - [Gmail](https://honcho.dev/docs/v3/guides/gmail.md): Load Gmail threads into Honcho to give your AI agents memory of email conversations. - [Agent Zero](https://honcho.dev/docs/v3/guides/community/agent0.md): Add AI-native memory to Agent Zero - [Pi](https://honcho.dev/docs/v3/guides/community/pi-honcho-memory.md): Persistent memory extension for the pi coding agent - [Migrating from Mem0](https://honcho.dev/docs/v3/guides/migrations/mem0.md): A guide to migrate from Mem0 to Honcho - [Local Environment Setup](https://honcho.dev/docs/v3/contributing/self-hosting.md): Set up a local environment to run Honcho for development, testing, or self-hosting - [Configuration Guide](https://honcho.dev/docs/v3/contributing/configuration.md): Complete reference for configuring Honcho providers, features, and infrastructure - [Changing Embeddings](https://honcho.dev/docs/v3/contributing/changing-embeddings.md): How to switch embedding dimension or model on a Honcho deployment - [Troubleshooting](https://honcho.dev/docs/v3/contributing/troubleshooting.md): Common issues and solutions when self-hosting Honcho - [Contributing Guidelines](https://honcho.dev/docs/v3/contributing/guidelines.md) - [License](https://honcho.dev/docs/v3/contributing/license.md) - [Introduction](https://honcho.dev/docs/v3/api-reference/introduction.md) - [Get Or Create Workspace](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/get-or-create-workspace.md): Get a Workspace by ID. - [Get All Workspaces](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/get-all-workspaces.md): Get all Workspaces, paginated with optional filters. - [Update Workspace](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/update-workspace.md): Update Workspace metadata and/or configuration. - [Delete Workspace](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/delete-workspace.md): Delete a Workspace. This accepts the deletion request and processes it in the background, permanently deleting all peers, messages, conclusions, and other resources associated with the workspace. - [Search Workspace](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/search-workspace.md): Search messages in a Workspace using optional filters. Use `limit` to control the number of results returned. - [Workspace Chat](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/chat-workspace.md): Query the entire workspace using natural language. Runs the Dialectic agent over every peer in the workspace rather than a single (observer, observed) pair: there is no anchor peer and no `target`. - [Get Queue Status](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/get-queue-status.md): Get the processing queue status for a Workspace, optionally scoped to an observer, sender, and/or session. - [Schedule Dream](https://honcho.dev/docs/v3/api-reference/endpoint/workspaces/schedule-dream.md): Manually schedule a dream task for a specific collection. - [Get Peers](https://honcho.dev/docs/v3/api-reference/endpoint/peers/get-peers.md): Get all Peers for a Workspace, paginated with optional filters. - [Get Or Create Peer](https://honcho.dev/docs/v3/api-reference/endpoint/peers/get-or-create-peer.md): Get a Peer by ID or create a new Peer with the given ID. - [Update Peer](https://honcho.dev/docs/v3/api-reference/endpoint/peers/update-peer.md): Update a Peer's metadata and/or configuration. - [Get Sessions For Peer](https://honcho.dev/docs/v3/api-reference/endpoint/peers/get-sessions-for-peer.md): Get all Sessions for a Peer, paginated with optional filters. - [Peer Chat](https://honcho.dev/docs/v3/api-reference/endpoint/peers/chat.md): Query a Peer's representation using natural language. Performs agentic search and reasoning to comprehensively answer the query based on all latent knowledge gathered about the peer from their messages and conclusions. - [Get Representation](https://honcho.dev/docs/v3/api-reference/endpoint/peers/get-representation.md): Get a curated subset of a Peer's Representation. A Representation is always a subset of the total knowledge about the Peer. The subset can be scoped and filtered in various ways. - [Get Peer Card](https://honcho.dev/docs/v3/api-reference/endpoint/peers/get-peer-card.md): Get a peer card for a specific peer relationship. - [Set Peer Card](https://honcho.dev/docs/v3/api-reference/endpoint/peers/set-peer-card.md): Set a peer card for a specific peer relationship. - [Get Peer Context](https://honcho.dev/docs/v3/api-reference/endpoint/peers/get-peer-context.md): Get context for a peer, including their representation and peer card. - [Search Peer](https://honcho.dev/docs/v3/api-reference/endpoint/peers/search-peer.md): Search a Peer's messages, optionally filtered by various criteria. - [Get Or Create Session](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/get-or-create-session.md): Get a Session by ID or create a new Session with the given ID. - [Get Sessions](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/get-sessions.md): Get all Sessions for a Workspace, paginated with optional filters. - [Update Session](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/update-session.md): Update a Session's metadata and/or configuration. - [Delete Session](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/delete-session.md): Delete a Session and all associated messages. - [Clone Session](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/clone-session.md): Clone a Session, optionally up to a specific message ID. - [Get Session Peers](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/get-session-peers.md): Get all Peers in a Session. Results are paginated. - [Set Session Peers](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/set-session-peers.md): Set the Peers in a Session. If a Peer does not yet exist, it will be created automatically. - [Add Peers To Session](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/add-peers-to-session.md): Add Peers to a Session. If a Peer does not yet exist, it will be created automatically. - [Remove Peers From Session](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/remove-peers-from-session.md): Remove Peers by ID from a Session. - [Get Peer Config](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/get-peer-config.md): Get the configuration for a Peer in a Session. - [Set Peer Config](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/set-peer-config.md): Set the configuration for a Peer in a Session. - [Get Session Context](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/get-session-context.md): 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 --… - [Get Session Summaries](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/get-session-summaries.md): Get available summaries for a Session. - [Search Session](https://honcho.dev/docs/v3/api-reference/endpoint/sessions/search-session.md): Search a Session with optional filters. Use `limit` to control the number of results returned. - [Get Or Create Scope](https://honcho.dev/docs/v3/api-reference/endpoint/scopes/get-or-create-scope.md): Get a Scope by ID or create a new Scope with the given ID. - [Get Scopes](https://honcho.dev/docs/v3/api-reference/endpoint/scopes/get-scopes.md): Get all Scopes for a Workspace. Results are paginated. - [Get Scope](https://honcho.dev/docs/v3/api-reference/endpoint/scopes/get-scope.md): Get a single Scope by ID. - [Add Sessions To Scope](https://honcho.dev/docs/v3/api-reference/endpoint/scopes/add-sessions-to-scope.md): Add Sessions to a Scope. - [Get Scope Sessions](https://honcho.dev/docs/v3/api-reference/endpoint/scopes/get-scope-sessions.md): Get the Sessions that are members of a Scope, paginated. - [Remove Session From Scope](https://honcho.dev/docs/v3/api-reference/endpoint/scopes/remove-session-from-scope.md): Remove a Session from a Scope. - [Get Scope Status](https://honcho.dev/docs/v3/api-reference/endpoint/scopes/get-scope-status.md): Get the backfill/reconciliation job status for a Scope. - [Create Messages For Session](https://honcho.dev/docs/v3/api-reference/endpoint/messages/create-messages-for-session.md): Add new message(s) to a session. - [Get Messages](https://honcho.dev/docs/v3/api-reference/endpoint/messages/get-messages.md): Get all messages for a Session with optional filters. Results are paginated. - [Get Message](https://honcho.dev/docs/v3/api-reference/endpoint/messages/get-message.md): Get a single message by ID from a Session. - [Update Message](https://honcho.dev/docs/v3/api-reference/endpoint/messages/update-message.md): Update the metadata of a message. - [Create Messages With File](https://honcho.dev/docs/v3/api-reference/endpoint/messages/create-messages-with-file.md): Create messages from uploaded files. Files are converted to text and split into multiple messages. - [Create Conclusions](https://honcho.dev/docs/v3/api-reference/endpoint/conclusions/create-conclusions.md): Create one or more Conclusions. - [List Conclusions](https://honcho.dev/docs/v3/api-reference/endpoint/conclusions/list-conclusions.md): List Conclusions using optional filters, ordered by recency unless `reverse` is true. Results are paginated. - [Query Conclusions](https://honcho.dev/docs/v3/api-reference/endpoint/conclusions/query-conclusions.md): Query Conclusions using semantic search. Use `top_k` to control the number of results returned. - [Delete Conclusion](https://honcho.dev/docs/v3/api-reference/endpoint/conclusions/delete-conclusion.md): Delete a single Conclusion by ID. - [List Webhook Endpoints](https://honcho.dev/docs/v3/api-reference/endpoint/webhooks/list-webhook-endpoints.md): List all webhook endpoints, optionally filtered by workspace. - [Get Or Create Webhook Endpoint](https://honcho.dev/docs/v3/api-reference/endpoint/webhooks/get-or-create-webhook-endpoint.md): Get or create a webhook endpoint URL. - [Delete Webhook Endpoint](https://honcho.dev/docs/v3/api-reference/endpoint/webhooks/delete-webhook-endpoint.md): Delete a specific webhook endpoint. - [Test Emit](https://honcho.dev/docs/v3/api-reference/endpoint/webhooks/test-emit.md): Test publishing a webhook event. - [Create Key](https://honcho.dev/docs/v3/api-reference/endpoint/keys/create-key.md): Create a new Key - [Changelog](https://honcho.dev/docs/changelog/introduction.md) - [SDK and API Compatibility Guide](https://honcho.dev/docs/changelog/compatibility-guide.md): Compatibility guide for Honcho's SDKs and API - [Honcho](https://honcho.dev/docs/v2/documentation/introduction/overview.md): Go beyond memory to agents with actual social intelligence - [Quickstart](https://honcho.dev/docs/v2/documentation/introduction/quickstart.md): Start building with Honcho in under 5 minutes. - [AI-Powered Honcho Setup](https://honcho.dev/docs/v2/documentation/introduction/vibecoding.md): Universal starter prompt for building with Honcho - [Architecture & Intuition](https://honcho.dev/docs/v2/documentation/core-concepts/architecture.md): Understanding Honcho's core concepts and data model. - [Storing Data](https://honcho.dev/docs/v2/documentation/core-concepts/features/storing-data.md): Store Data in Honcho to Generate Memories and Insights - [Dialectic Endpoint](https://honcho.dev/docs/v2/documentation/core-concepts/features/dialectic-endpoint.md): An endpoint for reasoning about your users - [Get Context](https://honcho.dev/docs/v2/documentation/core-concepts/features/get-context.md): Learn how to use get_context() to retrieve and format conversation context for LLM integration - [Search](https://honcho.dev/docs/v2/documentation/core-concepts/features/search.md): Learn how to search across workspaces, sessions, and peers to find relevant conversations and content - [Working Representations](https://honcho.dev/docs/v2/documentation/core-concepts/features/working-rep.md): Learn how to retrieve cached peer knowledge and understanding using Honcho's working representation system - [Streaming Responses](https://honcho.dev/docs/v2/documentation/core-concepts/features/streaming-response.md): Using streaming responses with Honcho SDKs - [Using Filters](https://honcho.dev/docs/v2/documentation/core-concepts/features/using-filters.md): Learn how to filter workspaces, peers, sessions, and messages using Honcho's powerful filtering system - [File Uploads](https://honcho.dev/docs/v2/documentation/core-concepts/features/file-uploads.md): Upload PDFs, text files, and JSON documents to create messages in Honcho - [Queue Status](https://honcho.dev/docs/v2/documentation/core-concepts/features/queue-status.md): Learn how to check the status of the Deriver - [Local vs Global Representations](https://honcho.dev/docs/v2/documentation/core-concepts/features/local-vs-global.md): Model directional relationships between Peers in Honcho - [Configure Reasoning](https://honcho.dev/docs/v2/documentation/core-concepts/configuration.md): Customizing how Honcho handles peers, sessions, and messages - [Summarizer](https://honcho.dev/docs/v2/documentation/core-concepts/summarizer.md): How Honcho creates summaries of conversations - [Terminology](https://honcho.dev/docs/v2/documentation/core-concepts/glossary.md): Glossary of AI and Honcho Specific Terms - [The Honcho Dashboard](https://honcho.dev/docs/v2/documentation/reference/platform.md): Build socially intelligent agents without worrying about infrastructure - [SDK Reference](https://honcho.dev/docs/v2/documentation/reference/sdk.md): Complete SDK documentation and examples for Python and TypeScript - [Spellbooks and Tutorials](https://honcho.dev/docs/v2/guides/overview.md): Helpful guides and design patterns for building with Honcho - [Migrating from Mem0](https://honcho.dev/docs/v2/migrations/from-mem0.md): A guide to migrate from Mem0 to Honcho - [CrewAI](https://honcho.dev/docs/v2/integrations/crewai.md): Build AI agents with persistent memory using CrewAI and Honcho - [LangGraph](https://honcho.dev/docs/v2/integrations/langgraph.md): Build a stateful conversational AI agent with LangGraph and Honcho - [Model Context Protocol (MCP)](https://honcho.dev/docs/v2/integrations/mcp.md): Use Honcho in Claude Desktop - [Discord Bots with Honcho](https://honcho.dev/docs/v2/guides/discord.md): Use Honcho to build a Discord bot with conversational memory and context management. - [n8n](https://honcho.dev/docs/v2/guides/n8n.md): Connect Honcho to your n8n workflows to build intelligent automation workflows and agents that leverage persistent memory across sessions. - [Telegram Bots with Honcho](https://honcho.dev/docs/v2/guides/telegram.md): Use Honcho to build a Telegram bot with conversational memory and context management. - [Introduction](https://honcho.dev/docs/v2/api-reference/introduction.md) - [Get Or Create Workspace](https://honcho.dev/docs/v2/api-reference/endpoint/workspaces/get-or-create-workspace.md): Get a Workspace by ID. - [Get All Workspaces](https://honcho.dev/docs/v2/api-reference/endpoint/workspaces/get-all-workspaces.md): Get all Workspaces - [Update Workspace](https://honcho.dev/docs/v2/api-reference/endpoint/workspaces/update-workspace.md): Update a Workspace - [Delete Workspace](https://honcho.dev/docs/v2/api-reference/endpoint/workspaces/delete-workspace.md): Delete a Workspace - [Search Workspace](https://honcho.dev/docs/v2/api-reference/endpoint/workspaces/search-workspace.md): Search a Workspace - [Get Deriver Status](https://honcho.dev/docs/v2/api-reference/endpoint/workspaces/get-deriver-status.md): Get the deriver processing status, optionally scoped to an observer, sender, and/or session - [Trigger Dream](https://honcho.dev/docs/v2/api-reference/endpoint/workspaces/trigger-dream.md): Manually trigger a dream task immediately for a specific collection. - [Get Peers](https://honcho.dev/docs/v2/api-reference/endpoint/peers/get-peers.md): Get All Peers for a Workspace - [Get Or Create Peer](https://honcho.dev/docs/v2/api-reference/endpoint/peers/get-or-create-peer.md): Get a Peer by ID - [Update Peer](https://honcho.dev/docs/v2/api-reference/endpoint/peers/update-peer.md): Update a Peer's name and/or metadata - [Get Sessions For Peer](https://honcho.dev/docs/v2/api-reference/endpoint/peers/get-sessions-for-peer.md): Get All Sessions for a Peer - [Chat](https://honcho.dev/docs/v2/api-reference/endpoint/peers/chat.md) - [Get Working Representation](https://honcho.dev/docs/v2/api-reference/endpoint/peers/get-working-representation.md): Get a peer's working representation for a session. - [Get Peer Card](https://honcho.dev/docs/v2/api-reference/endpoint/peers/get-peer-card.md): Get a peer card for a specific peer relationship. - [Set Peer Card](https://honcho.dev/docs/v2/api-reference/endpoint/peers/set-peer-card.md): Set a peer card for a specific peer relationship. - [Get Peer Context](https://honcho.dev/docs/v2/api-reference/endpoint/peers/get-peer-context.md): Get context for a peer, including their representation and peer card. - [Search Peer](https://honcho.dev/docs/v2/api-reference/endpoint/peers/search-peer.md): Search a Peer - [Get Or Create Session](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/get-or-create-session.md): Get a specific session in a workspace. - [Get Sessions](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/get-sessions.md): Get All Sessions in a Workspace - [Update Session](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/update-session.md): Update the metadata of a Session - [Delete Session](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/delete-session.md): Delete a session and all associated data. - [Clone Session](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/clone-session.md): Clone a session, optionally up to a specific message - [Get Session Peers](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/get-session-peers.md): Get peers from a session - [Set Session Peers](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/set-session-peers.md): Set the peers in a session - [Add Peers To Session](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/add-peers-to-session.md): Add peers to a session - [Remove Peers From Session](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/remove-peers-from-session.md): Remove peers from a session - [Get Peer Config](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/get-peer-config.md): Get the configuration for a peer in a session - [Set Peer Config](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/set-peer-config.md): Set the configuration for a peer in a session - [Get Session Context](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/get-session-context.md): 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 --… - [Get Session Summaries](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/get-session-summaries.md): Get available summaries for a session. - [Search Session](https://honcho.dev/docs/v2/api-reference/endpoint/sessions/search-session.md): Search a Session - [Create Messages For Session](https://honcho.dev/docs/v2/api-reference/endpoint/messages/create-messages-for-session.md): Add new message(s) to a session. - [Get Messages](https://honcho.dev/docs/v2/api-reference/endpoint/messages/get-messages.md): Get all messages for a session - [Get Message](https://honcho.dev/docs/v2/api-reference/endpoint/messages/get-message.md): Get a Message by ID - [Update Message](https://honcho.dev/docs/v2/api-reference/endpoint/messages/update-message.md): Update the metadata of a Message - [Create Messages With File](https://honcho.dev/docs/v2/api-reference/endpoint/messages/create-messages-with-file.md): Create messages from uploaded files. Files are converted to text and split into multiple messages. - [Create Observations](https://honcho.dev/docs/v2/api-reference/endpoint/observations/create-observations.md): Create one or more observations. - [List Observations](https://honcho.dev/docs/v2/api-reference/endpoint/observations/list-observations.md): List all observations using custom filters. Observations are listed by recency unless `reverse` is set to `true`. - [Query Observations](https://honcho.dev/docs/v2/api-reference/endpoint/observations/query-observations.md): Query observations using semantic search. - [Delete Observation](https://honcho.dev/docs/v2/api-reference/endpoint/observations/delete-observation.md): Delete a specific observation. - [List Webhook Endpoints](https://honcho.dev/docs/v2/api-reference/endpoint/webhooks/list-webhook-endpoints.md): List all webhook endpoints, optionally filtered by workspace. - [Get Or Create Webhook Endpoint](https://honcho.dev/docs/v2/api-reference/endpoint/webhooks/get-or-create-webhook-endpoint.md): Get or create a webhook endpoint URL. - [Delete Webhook Endpoint](https://honcho.dev/docs/v2/api-reference/endpoint/webhooks/delete-webhook-endpoint.md): Delete a specific webhook endpoint. - [Test Emit](https://honcho.dev/docs/v2/api-reference/endpoint/webhooks/test-emit.md): Test publishing a webhook event. - [Create Key](https://honcho.dev/docs/v2/api-reference/endpoint/keys/create-key.md): Create a new Key - [Metrics](https://honcho.dev/docs/v2/api-reference/endpoint/metrics.md): Prometheus metrics endpoint - [Contributing Guidelines](https://honcho.dev/docs/v2/contributing/guidelines.md) - [Local Environment Setup](https://honcho.dev/docs/v2/contributing/self-hosting.md): Set up a local environment to run Honcho for development, testing, or self-hosting - [Configuration Guide](https://honcho.dev/docs/v2/contributing/configuration.md): Complete guide to configuring Honcho for development and production - [License](https://honcho.dev/docs/v2/contributing/license.md) - [🫡 Welcome to Honcho](https://honcho.dev/docs/v1/getting-started/introduction.md): The identity layer for the agentic world - [Quickstart](https://honcho.dev/docs/v1/getting-started/quickstart.md): Start building with Honcho in under 5 minutes - [Architecture](https://honcho.dev/docs/v1/getting-started/architecture.md): Learn the core primitives and the structure of Honcho - [Guidelines](https://honcho.dev/docs/v1/contributing/guidelines.md): Guidelines for contributing to the Honcho Project - [Self-Hosting Honcho](https://honcho.dev/docs/v1/contributing/self-hosting.md): Running a local version of the Honcho API Server - [Deploying Honcho](https://honcho.dev/docs/v1/contributing/deploying.md): Deploying the Honcho API Server with Docker - [License](https://honcho.dev/docs/v1/contributing/license.md) - [Spellbooks and Tutorials](https://honcho.dev/docs/v1/guides/overview.md): Helpful guides and design patterns for building with Honcho - [Streaming Responses](https://honcho.dev/docs/v1/guides/streaming-response.md): Using streaming responses with Honcho SDKs - [Discord Bots with Honcho](https://honcho.dev/docs/v1/guides/discord.md): Discord is a powerful chat application that handles many UI complications - [Honcho MCP](https://honcho.dev/docs/v1/guides/honcho-mcp.md): Use Honcho in Claude Desktop - [Dialectic Endpoint](https://honcho.dev/docs/v1/guides/dialectic-endpoint.md): An endpoint for reasoning about your users - [Introduction](https://honcho.dev/docs/v1/api-reference/introduction.md) - [Get App](https://honcho.dev/docs/v1/api-reference/endpoint/apps/get-app.md): Get an App by ID. - [Get All Apps](https://honcho.dev/docs/v1/api-reference/endpoint/apps/get-all-apps.md): Get all Apps - [Update App](https://honcho.dev/docs/v1/api-reference/endpoint/apps/update-app.md): Update an App - [Get App By Name](https://honcho.dev/docs/v1/api-reference/endpoint/apps/get-app-by-name.md): Get an App by Name - [Create App](https://honcho.dev/docs/v1/api-reference/endpoint/apps/create-app.md): Create a new App - [Get Or Create App](https://honcho.dev/docs/v1/api-reference/endpoint/apps/get-or-create-app.md): Get or Create an App - [Get Sessions](https://honcho.dev/docs/v1/api-reference/endpoint/sessions/get-sessions.md): Get All Sessions for a User - [Create Session](https://honcho.dev/docs/v1/api-reference/endpoint/sessions/create-session.md): Create a Session for a User - [Get Session](https://honcho.dev/docs/v1/api-reference/endpoint/sessions/get-session.md): Get a specific session for a user. - [Update Session](https://honcho.dev/docs/v1/api-reference/endpoint/sessions/update-session.md): Update the metadata of a Session - [Delete Session](https://honcho.dev/docs/v1/api-reference/endpoint/sessions/delete-session.md): Delete a session by marking it as inactive - [Chat](https://honcho.dev/docs/v1/api-reference/endpoint/sessions/chat.md): Chat with the Dialectic API - [Clone Session](https://honcho.dev/docs/v1/api-reference/endpoint/sessions/clone-session.md): Clone a session, optionally up to a specific message - [Get Users](https://honcho.dev/docs/v1/api-reference/endpoint/users/get-users.md): Get All Users for an App - [Create User](https://honcho.dev/docs/v1/api-reference/endpoint/users/create-user.md): Create a new User - [Get User By Name](https://honcho.dev/docs/v1/api-reference/endpoint/users/get-user-by-name.md): Get a User by name - [Get User](https://honcho.dev/docs/v1/api-reference/endpoint/users/get-user.md): Get a User by ID - [Get Or Create User](https://honcho.dev/docs/v1/api-reference/endpoint/users/get-or-create-user.md): Get a User or create a new one by the input name - [Update User](https://honcho.dev/docs/v1/api-reference/endpoint/users/update-user.md): Update a User's name and/or metadata - [Get Messages](https://honcho.dev/docs/v1/api-reference/endpoint/messages/get-messages.md): Get all messages for a session - [Create Message For Session](https://honcho.dev/docs/v1/api-reference/endpoint/messages/create-message-for-session.md): Adds a message to a session - [Create Batch Messages For Session](https://honcho.dev/docs/v1/api-reference/endpoint/messages/create-batch-messages-for-session.md): Bulk create messages for a session while maintaining order. Maximum 100 messages per batch. - [Get Message](https://honcho.dev/docs/v1/api-reference/endpoint/messages/get-message.md): Get a Message by ID - [Update Message](https://honcho.dev/docs/v1/api-reference/endpoint/messages/update-message.md): Update the metadata of a Message - [Create Key](https://honcho.dev/docs/v1/api-reference/endpoint/keys/create-key.md): Create a new Key - [Create Metamessage](https://honcho.dev/docs/v1/api-reference/endpoint/metamessages/create-metamessage.md): Create a new metamessage associated with a user. Optionally link to a session and message by providing those IDs in the request body. - [Get Metamessages](https://honcho.dev/docs/v1/api-reference/endpoint/metamessages/get-metamessages.md): Get metamessages with flexible filtering. - [Get Metamessage](https://honcho.dev/docs/v1/api-reference/endpoint/metamessages/get-metamessage.md): Get a specific Metamessage by ID - [Update Metamessage](https://honcho.dev/docs/v1/api-reference/endpoint/metamessages/update-metamessage.md): Update a metamessage's metadata, type, or relationships - [Get Collections](https://honcho.dev/docs/v1/api-reference/endpoint/collections/get-collections.md): Get All Collections for a User - [Create Collection](https://honcho.dev/docs/v1/api-reference/endpoint/collections/create-collection.md): Create a new Collection - [Get Collection By Name](https://honcho.dev/docs/v1/api-reference/endpoint/collections/get-collection-by-name.md): Get a Collection by Name - [Get Collection](https://honcho.dev/docs/v1/api-reference/endpoint/collections/get-collection.md): Get a specific collection for a user. - [Update Collection](https://honcho.dev/docs/v1/api-reference/endpoint/collections/update-collection.md): Update a Collection's name or metadata - [Delete Collection](https://honcho.dev/docs/v1/api-reference/endpoint/collections/delete-collection.md): Delete a Collection and its documents - [Get Documents](https://honcho.dev/docs/v1/api-reference/endpoint/documents/get-documents.md): Get all of the Documents in a Collection - [Create Document](https://honcho.dev/docs/v1/api-reference/endpoint/documents/create-document.md): Embed text as a vector and create a Document - [Get Document](https://honcho.dev/docs/v1/api-reference/endpoint/documents/get-document.md): Get a document by ID - [Update Document](https://honcho.dev/docs/v1/api-reference/endpoint/documents/update-document.md): Update the content and/or the metadata of a Document - [Delete Document](https://honcho.dev/docs/v1/api-reference/endpoint/documents/delete-document.md): Delete a Document by ID - [Query Documents](https://honcho.dev/docs/v1/api-reference/endpoint/documents/query-documents.md): Cosine Similarity Search for Documents ## OpenAPI Specs - [openapi](/docs/v1/openapi.json) - [openapi](/docs/v2/openapi.json) - [openapi](/docs/v3/openapi.json)