{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "mint",
  "name": "Honcho",
  "redirects": [
    {
      "source": "/",
      "destination": "/v3/documentation/introduction/overview"
    },
    {
      "source": "/v3/guides/integrations/claudecode",
      "destination": "/v3/guides/integrations/claude-code"
    }
  ],
  "colors": {
    "primary": "#66AAFF",
    "dark": "#151E27",
    "light": "#86BCF2"
  },
  "favicon": "/favicon.svg",
  "contextual": {
    "options": ["copy", "view", "chatgpt", "claude"]
  },
  "navigation": {
    "versions": [
      {
        "version": "v3.1.0",
        "api": {
          "openapi": ["v3/openapi.json"]
        },
        "tabs": [
          {
            "tab": "Documentation",
            "groups": [
              {
                "group": "Introduction",
                "pages": [
                  "v3/documentation/introduction/overview",
                  "v3/documentation/introduction/quickstart",
                  "v3/documentation/introduction/vibecoding"
                ]
              },
              {
                "group": "Core Concepts",
                "pages": [
                  "v3/documentation/core-concepts/architecture",
                  "v3/documentation/core-concepts/reasoning",
                  "v3/documentation/core-concepts/representation",
                  "v3/documentation/core-concepts/design-patterns"
                ]
              },
              {
                "group": "Features",
                "pages": [
                  "v3/documentation/features/storing-data",
                  "v3/documentation/features/get-context",
                  "v3/documentation/features/chat",
                  {
                    "group": "Advanced",
                    "pages": [
                      "v3/documentation/features/advanced/overview",
                      "v3/documentation/features/advanced/reasoning-configuration",
                      "v3/documentation/features/advanced/summarizer",
                      "v3/documentation/features/advanced/peer-card",
                      "v3/documentation/features/advanced/representation-scopes",
                      "v3/documentation/features/advanced/dreaming",
                      "v3/documentation/features/advanced/queue-status",
                      "v3/documentation/features/advanced/webhooks",
                      "v3/documentation/features/advanced/search",
                      "v3/documentation/features/advanced/using-filters",
                      "v3/documentation/features/advanced/structured-outputs",
                      "v3/documentation/features/advanced/streaming-response",
                      "v3/documentation/features/advanced/file-uploads"
                    ]
                  }
                ]
              },
              {
                "group": "Reference",
                "pages": [
                  "v3/documentation/reference/platform",
                  "v3/documentation/reference/sdk",
                  "v3/documentation/reference/cli"
                ]
              }
            ]
          },
          {
            "tab": "Guides",
            "groups": [
              {
                "group": "Overview",
                "pages": ["v3/guides/overview"]
              },
              {
                "group": "Integrations",
                "pages": [
                  "v3/guides/integrations/claude-code",
                  "v3/guides/integrations/opencode",
                  "v3/guides/integrations/codex",
                  "v3/guides/integrations/vercel-ai-sdk",
                  "v3/guides/integrations/crewai",
                  "v3/guides/integrations/langgraph",
                  "v3/guides/integrations/mcp",
                  "v3/guides/integrations/n8n",
                  "v3/guides/integrations/openclaw",
                  "v3/guides/integrations/hermes",
                  "v3/guides/integrations/zo-computer",
                  "v3/guides/integrations/paperclip",
                  "v3/guides/integrations/sillytavern"
                ]
              },
              {
                "group": "Tutorials",
                "pages": [
                  "v3/guides/recipes/unified-memory-setup",
                  "v3/guides/discord",
                  "v3/guides/granola",
                  "v3/guides/telegram",
                  "v3/guides/integrations/reachy-mini",
                  "v3/guides/gmail"
                ]
              },
              {
                "group": "Community Integrations",
                "pages": [
                  "v3/guides/community/agent0",
                  "v3/guides/community/pi-honcho-memory"
                ]
              },
              {
                "group": "Migrations",
                "pages": ["v3/guides/migrations/mem0"]
              }
            ]
          },
          {
            "tab": "Open Source",
            "groups": [
              {
                "group": "Self-Hosting",
                "pages": [
                  "v3/contributing/self-hosting",
                  "v3/contributing/configuration",
                  "v3/contributing/changing-embeddings",
                  "v3/contributing/troubleshooting"
                ]
              },
              {
                "group": "Contributing",
                "pages": [
                  "v3/contributing/guidelines",
                  "v3/contributing/license"
                ]
              }
            ]
          },
          {
            "tab": "API Reference",
            "groups": [
              {
                "group": "API Documentation",
                "pages": ["v3/api-reference/introduction"]
              },
              {
                "group": "workspaces",
                "pages": [
                  "v3/api-reference/endpoint/workspaces/get-or-create-workspace",
                  "v3/api-reference/endpoint/workspaces/get-all-workspaces",
                  "v3/api-reference/endpoint/workspaces/update-workspace",
                  "v3/api-reference/endpoint/workspaces/delete-workspace",
                  "v3/api-reference/endpoint/workspaces/search-workspace",
                  "v3/api-reference/endpoint/workspaces/get-queue-status",
                  "v3/api-reference/endpoint/workspaces/schedule-dream"
                ]
              },
              {
                "group": "peers",
                "pages": [
                  "v3/api-reference/endpoint/peers/get-peers",
                  "v3/api-reference/endpoint/peers/get-or-create-peer",
                  "v3/api-reference/endpoint/peers/update-peer",
                  "v3/api-reference/endpoint/peers/get-sessions-for-peer",
                  "v3/api-reference/endpoint/peers/chat",
                  "v3/api-reference/endpoint/peers/get-representation",
                  "v3/api-reference/endpoint/peers/get-peer-card",
                  "v3/api-reference/endpoint/peers/set-peer-card",
                  "v3/api-reference/endpoint/peers/get-peer-context",
                  "v3/api-reference/endpoint/peers/search-peer"
                ]
              },
              {
                "group": "sessions",
                "pages": [
                  "v3/api-reference/endpoint/sessions/get-or-create-session",
                  "v3/api-reference/endpoint/sessions/get-sessions",
                  "v3/api-reference/endpoint/sessions/update-session",
                  "v3/api-reference/endpoint/sessions/delete-session",
                  "v3/api-reference/endpoint/sessions/clone-session",
                  "v3/api-reference/endpoint/sessions/get-session-peers",
                  "v3/api-reference/endpoint/sessions/set-session-peers",
                  "v3/api-reference/endpoint/sessions/add-peers-to-session",
                  "v3/api-reference/endpoint/sessions/remove-peers-from-session",
                  "v3/api-reference/endpoint/sessions/get-peer-config",
                  "v3/api-reference/endpoint/sessions/set-peer-config",
                  "v3/api-reference/endpoint/sessions/get-session-context",
                  "v3/api-reference/endpoint/sessions/get-session-summaries",
                  "v3/api-reference/endpoint/sessions/search-session"
                ]
              },
              {
                "group": "messages",
                "pages": [
                  "v3/api-reference/endpoint/messages/create-messages-for-session",
                  "v3/api-reference/endpoint/messages/get-messages",
                  "v3/api-reference/endpoint/messages/get-message",
                  "v3/api-reference/endpoint/messages/update-message",
                  "v3/api-reference/endpoint/messages/create-messages-with-file"
                ]
              },
              {
                "group": "conclusions",
                "pages": [
                  "v3/api-reference/endpoint/conclusions/create-conclusions",
                  "v3/api-reference/endpoint/conclusions/list-conclusions",
                  "v3/api-reference/endpoint/conclusions/query-conclusions",
                  "v3/api-reference/endpoint/conclusions/delete-conclusion"
                ]
              },
              {
                "group": "webhooks",
                "pages": [
                  "v3/api-reference/endpoint/webhooks/list-webhook-endpoints",
                  "v3/api-reference/endpoint/webhooks/get-or-create-webhook-endpoint",
                  "v3/api-reference/endpoint/webhooks/delete-webhook-endpoint",
                  "v3/api-reference/endpoint/webhooks/test-emit"
                ]
              },
              {
                "group": "miscellaneous",
                "pages": ["v3/api-reference/endpoint/keys/create-key"]
              }
            ]
          },
          {
            "tab": "Changelog",
            "groups": [
              {
                "group": "Overview",
                "pages": [
                  "changelog/introduction",
                  "changelog/compatibility-guide"
                ]
              }
            ]
          }
        ]
      },
      {
        "version": "v2.5.1",
        "api": {
          "openapi": ["v2/openapi.json"]
        },
        "tabs": [
          {
            "tab": "Documentation",
            "groups": [
              {
                "group": "Introduction",
                "pages": [
                  "v2/documentation/introduction/overview",
                  "v2/documentation/introduction/quickstart",
                  "v2/documentation/introduction/vibecoding"
                ]
              },
              {
                "group": "Core Concepts",
                "pages": [
                  "v2/documentation/core-concepts/architecture",
                  "v2/documentation/core-concepts/features/storing-data",
                  "v2/documentation/core-concepts/features/dialectic-endpoint",
                  "v2/documentation/core-concepts/features/get-context",
                  "v2/documentation/core-concepts/features/search",
                  "v2/documentation/core-concepts/features/working-rep",
                  "v2/documentation/core-concepts/features/streaming-response",
                  "v2/documentation/core-concepts/features/using-filters",
                  "v2/documentation/core-concepts/features/file-uploads",
                  "v2/documentation/core-concepts/features/queue-status",
                  "v2/documentation/core-concepts/features/local-vs-global",
                  "v2/documentation/core-concepts/configuration",
                  "v2/documentation/core-concepts/summarizer",
                  "v2/documentation/core-concepts/glossary"
                ]
              },
              {
                "group": "Reference",
                "pages": [
                  "v2/documentation/reference/platform",
                  "v2/documentation/reference/sdk"
                ]
              }
            ]
          },
          {
            "tab": "Spellbooks",
            "groups": [
              {
                "group": "Getting Started",
                "pages": ["v2/guides/overview"]
              },
              {
                "group": "Migrations",
                "pages": ["v2/migrations/from-mem0"]
              },
              {
                "group": "Integrations",
                "pages": [
                  "v2/integrations/crewai",
                  "v2/integrations/langgraph",
                  "v2/integrations/mcp"
                ]
              },
              {
                "group": "Application Interfaces",
                "pages": [
                  "v2/guides/discord",
                  "v2/guides/n8n",
                  "v2/guides/telegram"
                ]
              }
            ]
          },
          {
            "tab": "API Reference",
            "groups": [
              {
                "group": "API Documentation",
                "pages": ["v2/api-reference/introduction"]
              },
              {
                "group": "workspaces",
                "pages": [
                  "v2/api-reference/endpoint/workspaces/get-or-create-workspace",
                  "v2/api-reference/endpoint/workspaces/get-all-workspaces",
                  "v2/api-reference/endpoint/workspaces/update-workspace",
                  "v2/api-reference/endpoint/workspaces/delete-workspace",
                  "v2/api-reference/endpoint/workspaces/search-workspace",
                  "v2/api-reference/endpoint/workspaces/get-deriver-status",
                  "v2/api-reference/endpoint/workspaces/trigger-dream"
                ]
              },
              {
                "group": "peers",
                "pages": [
                  "v2/api-reference/endpoint/peers/get-peers",
                  "v2/api-reference/endpoint/peers/get-or-create-peer",
                  "v2/api-reference/endpoint/peers/update-peer",
                  "v2/api-reference/endpoint/peers/get-sessions-for-peer",
                  "v2/api-reference/endpoint/peers/chat",
                  "v2/api-reference/endpoint/peers/get-working-representation",
                  "v2/api-reference/endpoint/peers/get-peer-card",
                  "v2/api-reference/endpoint/peers/set-peer-card",
                  "v2/api-reference/endpoint/peers/get-peer-context",
                  "v2/api-reference/endpoint/peers/search-peer"
                ]
              },
              {
                "group": "sessions",
                "pages": [
                  "v2/api-reference/endpoint/sessions/get-or-create-session",
                  "v2/api-reference/endpoint/sessions/get-sessions",
                  "v2/api-reference/endpoint/sessions/update-session",
                  "v2/api-reference/endpoint/sessions/delete-session",
                  "v2/api-reference/endpoint/sessions/clone-session",
                  "v2/api-reference/endpoint/sessions/get-session-peers",
                  "v2/api-reference/endpoint/sessions/set-session-peers",
                  "v2/api-reference/endpoint/sessions/add-peers-to-session",
                  "v2/api-reference/endpoint/sessions/remove-peers-from-session",
                  "v2/api-reference/endpoint/sessions/get-peer-config",
                  "v2/api-reference/endpoint/sessions/set-peer-config",
                  "v2/api-reference/endpoint/sessions/get-session-context",
                  "v2/api-reference/endpoint/sessions/get-session-summaries",
                  "v2/api-reference/endpoint/sessions/search-session"
                ]
              },
              {
                "group": "messages",
                "pages": [
                  "v2/api-reference/endpoint/messages/create-messages-for-session",
                  "v2/api-reference/endpoint/messages/get-messages",
                  "v2/api-reference/endpoint/messages/get-message",
                  "v2/api-reference/endpoint/messages/update-message",
                  "v2/api-reference/endpoint/messages/create-messages-with-file"
                ]
              },
              {
                "group": "observations",
                "pages": [
                  "v2/api-reference/endpoint/observations/create-observations",
                  "v2/api-reference/endpoint/observations/list-observations",
                  "v2/api-reference/endpoint/observations/query-observations",
                  "v2/api-reference/endpoint/observations/delete-observation"
                ]
              },
              {
                "group": "webhooks",
                "pages": [
                  "v2/api-reference/endpoint/webhooks/list-webhook-endpoints",
                  "v2/api-reference/endpoint/webhooks/get-or-create-webhook-endpoint",
                  "v2/api-reference/endpoint/webhooks/delete-webhook-endpoint",
                  "v2/api-reference/endpoint/webhooks/test-emit"
                ]
              },
              {
                "group": "miscellaneous",
                "pages": [
                  "v2/api-reference/endpoint/keys/create-key",
                  "v2/api-reference/endpoint/metrics"
                ]
              }
            ]
          },
          {
            "tab": "Contributing",
            "groups": [
              {
                "group": "Contributing",
                "pages": [
                  "v2/contributing/guidelines",
                  "v2/contributing/self-hosting",
                  "v2/contributing/configuration",
                  "v2/contributing/license"
                ]
              }
            ]
          }
        ]
      },
      {
        "version": "v1.1.0",
        "api": {
          "openapi": ["openapi.json"]
        },
        "tabs": [
          {
            "tab": "Documentation",
            "groups": [
              {
                "group": "Get Started",
                "pages": [
                  "v1/getting-started/introduction",
                  "v1/getting-started/quickstart",
                  "v1/getting-started/architecture"
                ]
              },
              {
                "group": "Contributing",
                "pages": [
                  "v1/contributing/guidelines",
                  "v1/contributing/self-hosting",
                  "v1/contributing/deploying",
                  "v1/contributing/license"
                ]
              }
            ]
          },
          {
            "tab": "Spellbooks and Tutorials",
            "groups": [
              {
                "group": "Getting Started",
                "pages": ["v1/guides/overview", "v1/guides/streaming-response"]
              },
              {
                "group": "Application Interfaces",
                "pages": ["v1/guides/discord", "v1/guides/honcho-mcp"]
              },
              {
                "group": "Personal Memory",
                "pages": ["v1/guides/dialectic-endpoint"]
              }
            ]
          },
          {
            "tab": "API Reference",
            "groups": [
              {
                "group": "API Documentation",
                "pages": ["v1/api-reference/introduction"]
              },
              {
                "group": "apps",
                "pages": [
                  "v1/api-reference/endpoint/apps/get-app",
                  "v1/api-reference/endpoint/apps/get-all-apps",
                  "v1/api-reference/endpoint/apps/update-app",
                  "v1/api-reference/endpoint/apps/get-app-by-name",
                  "v1/api-reference/endpoint/apps/create-app",
                  "v1/api-reference/endpoint/apps/get-or-create-app"
                ]
              },
              {
                "group": "sessions",
                "pages": [
                  "v1/api-reference/endpoint/sessions/get-sessions",
                  "v1/api-reference/endpoint/sessions/create-session",
                  "v1/api-reference/endpoint/sessions/get-session",
                  "v1/api-reference/endpoint/sessions/update-session",
                  "v1/api-reference/endpoint/sessions/delete-session",
                  "v1/api-reference/endpoint/sessions/chat",
                  "v1/api-reference/endpoint/sessions/clone-session"
                ]
              },
              {
                "group": "users",
                "pages": [
                  "v1/api-reference/endpoint/users/get-users",
                  "v1/api-reference/endpoint/users/create-user",
                  "v1/api-reference/endpoint/users/get-user-by-name",
                  "v1/api-reference/endpoint/users/get-user",
                  "v1/api-reference/endpoint/users/get-or-create-user",
                  "v1/api-reference/endpoint/users/update-user"
                ]
              },
              {
                "group": "messages",
                "pages": [
                  "v1/api-reference/endpoint/messages/get-messages",
                  "v1/api-reference/endpoint/messages/create-message-for-session",
                  "v1/api-reference/endpoint/messages/create-batch-messages-for-session",
                  "v1/api-reference/endpoint/messages/get-message",
                  "v1/api-reference/endpoint/messages/update-message"
                ]
              },
              {
                "group": "keys",
                "pages": ["v1/api-reference/endpoint/keys/create-key"]
              },
              {
                "group": "metamessages",
                "pages": [
                  "v1/api-reference/endpoint/metamessages/create-metamessage",
                  "v1/api-reference/endpoint/metamessages/get-metamessages",
                  "v1/api-reference/endpoint/metamessages/get-metamessage",
                  "v1/api-reference/endpoint/metamessages/update-metamessage"
                ]
              },
              {
                "group": "collections",
                "pages": [
                  "v1/api-reference/endpoint/collections/get-collections",
                  "v1/api-reference/endpoint/collections/create-collection",
                  "v1/api-reference/endpoint/collections/get-collection-by-name",
                  "v1/api-reference/endpoint/collections/get-collection",
                  "v1/api-reference/endpoint/collections/update-collection",
                  "v1/api-reference/endpoint/collections/delete-collection"
                ]
              },
              {
                "group": "documents",
                "pages": [
                  "v1/api-reference/endpoint/documents/get-documents",
                  "v1/api-reference/endpoint/documents/create-document",
                  "v1/api-reference/endpoint/documents/get-document",
                  "v1/api-reference/endpoint/documents/update-document",
                  "v1/api-reference/endpoint/documents/delete-document",
                  "v1/api-reference/endpoint/documents/query-documents"
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "logo": {
    "light": "/logo/honcho-dark.svg",
    "dark": "/logo/honcho-light.svg"
  },
  "navbar": {
    "primary": {
      "type": "github",
      "href": "https://github.com/plastic-labs/honcho"
    }
  },
  "footer": {
    "socials": {
      "twitter": "https://x.com/honchodotdev",
      "github": "https://github.com/plastic-labs/honcho",
      "discord": "https://discord.gg/honcho",
      "linkedin": "https://www.linkedin.com/company/plasticlabs",
      "youtube": "https://www.youtube.com/@plasticlabs"
    }
  },
  "integrations": {
    "gtm": {
      "tagId": "GTM-NSPT9PJF"
    }
  }
}