# Honcho

## Docs

- [SDK and API Compatibility Guide](https://docs.honcho.dev/changelog/compatibility-guide.md): Compatibility guide for Honcho's SDKs and API
- [Changelog](https://docs.honcho.dev/changelog/introduction.md)
- [Create Key](https://docs.honcho.dev/v2/api-reference/endpoint/keys/create-key.md): Create a new Key
- [Create Messages For Session](https://docs.honcho.dev/v2/api-reference/endpoint/messages/create-messages-for-session.md): Create messages for a session with JSON data (original functionality).
- [Create Messages With File](https://docs.honcho.dev/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.
- [Get Message](https://docs.honcho.dev/v2/api-reference/endpoint/messages/get-message.md): Get a Message by ID
- [Get Messages](https://docs.honcho.dev/v2/api-reference/endpoint/messages/get-messages.md): Get all messages for a session
- [Update Message](https://docs.honcho.dev/v2/api-reference/endpoint/messages/update-message.md): Update the metadata of a Message
- [Metrics](https://docs.honcho.dev/v2/api-reference/endpoint/metrics.md): Prometheus metrics endpoint
- [Chat](https://docs.honcho.dev/v2/api-reference/endpoint/peers/chat.md)
- [Get Or Create Peer](https://docs.honcho.dev/v2/api-reference/endpoint/peers/get-or-create-peer.md): Get a Peer by ID

If peer_id is provided as a query parameter, it uses that (must match JWT workspace_id).
Otherwise, it uses the peer_id from the JWT.
- [Get Peer Card](https://docs.honcho.dev/v2/api-reference/endpoint/peers/get-peer-card.md): Get a peer card for a specific peer relationship.

Returns the peer card that the observer peer has for the target peer if it exists.
If no target is specified, returns the observer's own peer card.
- [Get Peers](https://docs.honcho.dev/v2/api-reference/endpoint/peers/get-peers.md): Get All Peers for a Workspace
- [Get Sessions For Peer](https://docs.honcho.dev/v2/api-reference/endpoint/peers/get-sessions-for-peer.md): Get All Sessions for a Peer
- [Get Working Representation](https://docs.honcho.dev/v2/api-reference/endpoint/peers/get-working-representation.md): Get a peer's working representation for a session.

If a session_id is provided in the body, we get the working representation of the peer in that session.
If a target is provided, we get the representation of the target from the perspective of the peer.
If no target is provided, we get the omniscient Honcho representation of the peer.
- [Search Peer](https://docs.honcho.dev/v2/api-reference/endpoint/peers/search-peer.md): Search a Peer
- [Update Peer](https://docs.honcho.dev/v2/api-reference/endpoint/peers/update-peer.md): Update a Peer's name and/or metadata
- [Add Peers To Session](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/add-peers-to-session.md): Add peers to a session
- [Clone Session](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/clone-session.md): Clone a session, optionally up to a specific message
- [Delete Session](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/delete-session.md): Delete a session by marking it as inactive
- [Get Or Create Session](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/get-or-create-session.md): Get a specific session in a workspace.

If session_id is provided as a query parameter, it verifies the session is in the workspace.
Otherwise, it uses the session_id from the JWT for verification.
- [Get Peer Config](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/get-peer-config.md): Get the configuration for a peer in a session
- [Get Session Context](https://docs.honcho.dev/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 -- 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 Session Peers](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/get-session-peers.md): Get peers from a session
- [Get Session Summaries](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/get-session-summaries.md): Get available summaries for a session.

Returns both short and long summaries if available, including metadata like
the message ID they cover up to, creation timestamp, and token count.
- [Get Sessions](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/get-sessions.md): Get All Sessions in a Workspace
- [Remove Peers From Session](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/remove-peers-from-session.md): Remove peers from a session
- [Search Session](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/search-session.md): Search a Session
- [Set Peer Config](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/set-peer-config.md): Set the configuration for a peer in a session
- [Set Session Peers](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/set-session-peers.md): Set the peers in a session
- [Update Session](https://docs.honcho.dev/v2/api-reference/endpoint/sessions/update-session.md): Update the metadata of a Session
- [Delete Webhook Endpoint](https://docs.honcho.dev/v2/api-reference/endpoint/webhooks/delete-webhook-endpoint.md): Delete a specific webhook endpoint.
- [Get Or Create Webhook Endpoint](https://docs.honcho.dev/v2/api-reference/endpoint/webhooks/get-or-create-webhook-endpoint.md): Get or create a webhook endpoint URL.
- [List Webhook Endpoints](https://docs.honcho.dev/v2/api-reference/endpoint/webhooks/list-webhook-endpoints.md): List all webhook endpoints, optionally filtered by workspace.
- [Test Emit](https://docs.honcho.dev/v2/api-reference/endpoint/webhooks/test-emit.md): Test publishing a webhook event.
- [Delete Workspace](https://docs.honcho.dev/v2/api-reference/endpoint/workspaces/delete-workspace.md): Delete a Workspace
- [Get All Workspaces](https://docs.honcho.dev/v2/api-reference/endpoint/workspaces/get-all-workspaces.md): Get all Workspaces
- [Get Deriver Status](https://docs.honcho.dev/v2/api-reference/endpoint/workspaces/get-deriver-status.md): Get the deriver processing status, optionally scoped to an observer, sender, and/or session
- [Get Or Create Workspace](https://docs.honcho.dev/v2/api-reference/endpoint/workspaces/get-or-create-workspace.md): Get a Workspace by ID.

If workspace_id is provided as a query parameter, it uses that (must match JWT workspace_id).
Otherwise, it uses the workspace_id from the JWT.
- [Search Workspace](https://docs.honcho.dev/v2/api-reference/endpoint/workspaces/search-workspace.md): Search a Workspace
- [Update Workspace](https://docs.honcho.dev/v2/api-reference/endpoint/workspaces/update-workspace.md): Update a Workspace
- [Introduction](https://docs.honcho.dev/v2/api-reference/introduction.md)
- [Configuration Guide](https://docs.honcho.dev/v2/contributing/configuration.md): Complete guide to configuring Honcho for development and production
- [Contributing Guidelines](https://docs.honcho.dev/v2/contributing/guidelines.md)
- [License](https://docs.honcho.dev/v2/contributing/license.md)
- [Local Environment Setup](https://docs.honcho.dev/v2/contributing/self-hosting.md): Set up a local environment to run Honcho for development, testing, or self-hosting
- [Architecture & Intuition](https://docs.honcho.dev/v2/documentation/core-concepts/architecture.md): Understanding Honcho's core concepts and data model.
- [Configure Reasoning](https://docs.honcho.dev/v2/documentation/core-concepts/configuration.md): Customizing how Honcho handles peers and sessions
- [Dialectic Endpoint](https://docs.honcho.dev/v2/documentation/core-concepts/features/dialectic-endpoint.md): An endpoint for reasoning about your users
- [File Uploads](https://docs.honcho.dev/v2/documentation/core-concepts/features/file-uploads.md): Upload PDFs, text files, and JSON documents to create messages in Honcho
- [Get Context](https://docs.honcho.dev/v2/documentation/core-concepts/features/get-context.md): Learn how to use get_context() to retrieve and format conversation context for LLM integration
- [Local vs Global Representations](https://docs.honcho.dev/v2/documentation/core-concepts/features/local-vs-global.md): Model directional relationships between Peers in Honcho
- [Queue Status](https://docs.honcho.dev/v2/documentation/core-concepts/features/queue-status.md): Learn how to check the status of the Deriver
- [Search](https://docs.honcho.dev/v2/documentation/core-concepts/features/search.md): Learn how to search across workspaces, sessions, and peers to find relevant conversations and content
- [Storing Data](https://docs.honcho.dev/v2/documentation/core-concepts/features/storing-data.md): Store Data in Honcho to Generate Memories and Insights
- [Streaming Responses](https://docs.honcho.dev/v2/documentation/core-concepts/features/streaming-response.md): Using streaming responses with Honcho SDKs
- [Using Filters](https://docs.honcho.dev/v2/documentation/core-concepts/features/using-filters.md): Learn how to filter workspaces, peers, sessions, and messages using Honcho's powerful filtering system
- [Working Representations](https://docs.honcho.dev/v2/documentation/core-concepts/features/working-rep.md): Learn how to retrieve cached peer knowledge and understanding using Honcho's working representation system
- [Terminology](https://docs.honcho.dev/v2/documentation/core-concepts/glossary.md): Glossary of AI and Honcho Specific Terms
- [Summarizer](https://docs.honcho.dev/v2/documentation/core-concepts/summarizer.md): How Honcho creates summaries of conversations
- [Honcho](https://docs.honcho.dev/v2/documentation/introduction/overview.md): Go beyond memory to agents with actual social intelligence
- [Quickstart](https://docs.honcho.dev/v2/documentation/introduction/quickstart.md): Start building with Honcho in under 5 minutes.
- [AI-Powered Honcho Setup](https://docs.honcho.dev/v2/documentation/introduction/vibecoding.md): Universal starter prompt for building with Honcho
- [The Honcho Dashboard](https://docs.honcho.dev/v2/documentation/reference/platform.md): Build socially intelligent agents without worrying about infrastructure
- [SDK Reference](https://docs.honcho.dev/v2/documentation/reference/sdk.md): Complete SDK documentation and examples for Python and TypeScript
- [Discord Bots with Honcho](https://docs.honcho.dev/v2/guides/discord.md): Use Honcho to build a Discord bot with conversational memory and context management.
- [Honcho MCP](https://docs.honcho.dev/v2/guides/mcp.md): Use Honcho in Claude Desktop
- [Spellbooks and Tutorials](https://docs.honcho.dev/v2/guides/overview.md): Helpful guides and design patterns for building with Honcho
- [Telegram Bots with Honcho](https://docs.honcho.dev/v2/guides/telegram.md): Use Honcho to build a Telegram bot with conversational memory and context management.


## Optional

- [Dashboard](https://app.honcho.dev)
- [Community](https://discord.gg/honcho)
- [Blog](https://blog.plasticlabs.ai)