Honcho API v2.0.5 (Current)

Version Compatibility

Version Compatibility Table

Compatibility guide for Honcho's SDKs and API

SDK and API Compatibility Guide

Honcho

Overview

🫡 Welcome to Honcho

Start building with Honcho in under 5 minutes

Quickstart

Learn the core primitives and the structure of Honcho

Architecture

Guidelines for contributing to the Honcho Project

Guidelines

Running a local version of the Honcho API Server

Self-Hosting

Self-Hosting Honcho

Deploying the Honcho API Server with Docker

Deploying

Deploying Honcho

License

Helpful guides and design patterns for building with Honcho

Spellbooks and Tutorials

Using streaming responses with Honcho SDKs

Streaming Responses

Discord is a powerful chat application that handles many UI complications

Discord

Discord Bots with Honcho

Claude Desktop

Honcho MCP

An endpoint for reasoning about your users

Dialectic Endpoint

Introduction

Get an App by ID.

If app_id is provided as a query parameter, it uses that (must match JWT app_id).
Otherwise, it uses the app_id from the JWT token.

Get App

Get All Apps

Update App

Get App By Name

Create App

Get Or Create App

Get Users

Create User

Get User By Name

Get a User by ID

If user_id is provided as a query parameter, it uses that (must match JWT app_id).
Otherwise, it uses the user_id from the JWT token.

Get User

Get a User or create a new one by the input name

Get Or Create User

Update User

Get Sessions

Create Session

Get a specific session for a user.

If session_id is provided as a query parameter, it uses that (must match JWT session_id).
Otherwise, it uses the session_id from the JWT token.

Get Session

Update Session

Delete a session by marking it as inactive

Delete Session

Chat

Clone a session, optionally up to a specific message

Clone Session

Get Messages

Create Message For Session

Bulk create messages for a session while maintaining order. Maximum 100 messages per batch.

Create Batch Messages For Session

Get Message

Update Message

Create a new metamessage associated with a user.
Optionally link to a session and message by providing those IDs in the request body.

Create Metamessage

Get metamessages with flexible filtering.

- Filter by user only: No additional parameters needed
- Filter by session: Provide session_id
- Filter by message: Provide message_id (and session_id)
- Filter by type: Provide label
- Filter by metadata: Provide filter object

Get Metamessages

Get Metamessage

Update a metamessage's metadata, type, or relationships

Update Metamessage

Get Collections

Create Collection

Get Collection By Name

Get a specific collection for a user.

If collection_id is provided as a query parameter, it uses that (must match JWT collection_id).
Otherwise, it uses the collection_id from the JWT token.

Honcho API Version	TypeScript SDK	Python SDK
v2.0.5 (Current)	v1.1.0	v1.1.0	Latest release
v2.0.4	v1.1.0	v1.1.0

Overview

​Version Compatibility

​Honcho API v2.0.5 (Current)

TypeScript SDK

Python SDK

​Version Compatibility Table

Version Compatibility

Honcho API v2.0.5 (Current)

Version Compatibility Table