# B-Bot Hub ## Docs - [B-Bot Hub](https://docs.b-bot.space/introduction.md): A quick orientation to B-Bot Hub for creating agents, chatting, and managing your work - [Feature Availability](https://docs.b-bot.space/roadmap.md): What is available in B-Bot Hub, what depends on context, and what is coming soon - [Create an Agent](https://docs.b-bot.space/essentials/create-expert.md): Create an Agent from scratch or a template in B-Bot Hub - [Edit an Agent](https://docs.b-bot.space/essentials/edit-expert.md): Configure a saved agent across the five routed editor tabs - [Chat](https://docs.b-bot.space/essentials/chat.md): Start, continue, and manage Agent conversations in B-Bot Hub - [Threads](https://docs.b-bot.space/essentials/threads.md): Find, open, and remove saved conversations - [DeepAgents Workspace](https://docs.b-bot.space/essentials/deepagents-workspace.md): Understand task, file, preview, and memory panels used by DeepAgents - [Tasks](https://docs.b-bot.space/essentials/tasks.md): Schedule, trigger, inspect, and manage Agent automation - [Workflows](https://docs.b-bot.space/essentials/workflows.md): Build, test, run, and publish Agent workflows - [Resources](https://docs.b-bot.space/essentials/resources.md): Find files and projects created in Agent threads - [Knowledge](https://docs.b-bot.space/essentials/knowledge.md): Manage retrieval domains, documents, graphs, and access for an Agent - [Training](https://docs.b-bot.space/essentials/training.md): Create conversation examples and fine-tune a model for an Agent - [Apps](https://docs.b-bot.space/essentials/apps.md): Connect Composio apps and MCP servers to an Agent - [Distribution Channels](https://docs.b-bot.space/essentials/distribution-channels.md): Publish an Agent through supported Hub channels - [Dashboard](https://docs.b-bot.space/essentials/dashboard.md): Start work, reopen conversations, and review recent usage - [Profile](https://docs.b-bot.space/essentials/profile.md): View your account details and change your profile image - [Settings](https://docs.b-bot.space/essentials/settings.md): Choose a theme and language, and manage web push - [Keys](https://docs.b-bot.space/essentials/provider-keys.md): Manage personal and company provider credentials and B-Bot API keys - [Company and Billing](https://docs.b-bot.space/essentials/company-billing.md): Manage companies, members, shared agents, credentials, plans, and seats - [AI Image Generation](https://docs.b-bot.space/essentials/ai-image-generation.md): Upload, generate, or link profile and company images - [News, Tours, and Onboarding](https://docs.b-bot.space/essentials/news-tours.md): Discover product updates and guided paths through the current Hub - [Input and Output Modalities](https://docs.b-bot.space/essentials/modalities.md): Configure verified voice, file, image, and generated output options - [Hosting in Switzerland](https://docs.b-bot.space/declarations/hosting.md): Where the B-Bot Hub platform infrastructure is hosted - [B-Bot Hub Concepts](https://docs.b-bot.space/concepts.md): An overview of AI Agents, DeepAgents, multimodal workflows, training, and Distribution Channels in B-Bot Hub. - [AI Agents and Core Vocabulary](https://docs.b-bot.space/concepts/introduction.md): Learn what an AI Agent is and how B-Bot Hub describes identity, behavior, capabilities, and access. - [Agent Lifecycle and Configuration](https://docs.b-bot.space/concepts/basics.md): Understand the main configuration primitives and the lifecycle of an AI Agent in B-Bot Hub. - [Agent Architecture](https://docs.b-bot.space/concepts/architecture/agent-architecture.md): A conceptual view of how requests, Agent configuration, models, context, tools, and Distribution Channels work together. - [DeepAgents](https://docs.b-bot.space/concepts/deepagents/introduction.md): Understand how DeepAgents use tasks, workspace files, tools, and human review for multi-step work. - [Multimodal AI](https://docs.b-bot.space/concepts/multimodal/introduction.md): Understand how text, voice, images, and files can participate in an AI Agent workflow. - [Fine-Tuning](https://docs.b-bot.space/concepts/fine-tuning/introduction.md): Understand what fine-tuning changes, when to use it, and how to evaluate a trained model safely. - [Model Distillation](https://docs.b-bot.space/concepts/fine-tuning/model-distillation.md): Learn how to create, review, and evaluate teacher-generated examples for a smaller student model. - [Customer Support](https://docs.b-bot.space/concepts/use_cases/customer-support.md): Plan a customer support AI Agent with grounded answers, clear boundaries, and human escalation. - [Data Analysis](https://docs.b-bot.space/concepts/use_cases/data-analysis.md): Plan a traceable data analysis workflow with an AI Agent and optional DeepAgents workspace. - [Content Creation](https://docs.b-bot.space/concepts/use_cases/content-creation.md): Design a repeatable content workflow with clear briefs, source checks, and human editorial review. - [Design an AI Persona](https://docs.b-bot.space/concepts/best_practices/ai-persona-with-b-bot.md): Define a useful role, voice, boundaries, capabilities, and evaluation plan for an AI Agent. - [Craft a System Prompt](https://docs.b-bot.space/concepts/best_practices/crafting-a-system-prompt.md): Write clear, testable, and maintainable system instructions for an AI Agent. - [Javascript / TypeScript SDK](https://docs.b-bot.space/sdks/javascript.md): Use the official B-Bot SDK to integrate AI capabilities into your Javascript/TypeScript applications. - [API User Memories: Get Memories](https://docs.b-bot.space/mainapi-reference/api-user-memories/get-memories.md): List/search memories for one of your end-users (tenant-scoped, server-derived entity_id) - [API User Memories: Upsert Memory](https://docs.b-bot.space/mainapi-reference/api-user-memories/upsert-memory.md): Create or update a memory for one of your end-users (tenant-scoped) - [API User Memories: Delete Memory](https://docs.b-bot.space/mainapi-reference/api-user-memories/delete-memory.md): Delete a memory for one of your end-users (tenant-scoped) - [Distribution Channel Metadata](https://docs.b-bot.space/mainapi-reference/distribution-channels-metadata.md): Complete reference for Distribution Channel metadata structure and configuration options - [Create Distribution Channel](https://docs.b-bot.space/mainapi-reference/distribution-channels/create-distribution-channel.md): Create a distribution channel. - [Search Distribution Channels](https://docs.b-bot.space/mainapi-reference/distribution-channels/search-distribution-channels.md): Search for distribution channels. - [Count Distribution Channels](https://docs.b-bot.space/mainapi-reference/distribution-channels/count-distribution-channels.md): Get the count of distribution channels matching the specified criteria. - [Get Distribution Channel](https://docs.b-bot.space/mainapi-reference/distribution-channels/get-distribution-channel.md): Get a distribution channel by ID. - [Delete Distribution Channel](https://docs.b-bot.space/mainapi-reference/distribution-channels/delete-distribution-channel.md): Delete a distribution channel by ID. - [Patch Distribution Channel](https://docs.b-bot.space/mainapi-reference/distribution-channels/patch-distribution-channel.md): Update a distribution channel. - [Get Distribution Channel Graph](https://docs.b-bot.space/mainapi-reference/distribution-channels/get-distribution-channel-graph.md): Get a distribution channel's graph by ID. - [Get Distribution Channel Subgraphs](https://docs.b-bot.space/mainapi-reference/distribution-channels/get-distribution-channel-subgraphs.md): Get a distribution channel's subgraphs. - [Get Distribution Channel Subgraphs by Namespace](https://docs.b-bot.space/mainapi-reference/distribution-channels/get-distribution-channel-subgraphs-by-namespace.md): Get a distribution channel's subgraphs filtered by namespace. - [Get Distribution Channel Schemas](https://docs.b-bot.space/mainapi-reference/distribution-channels/get-distribution-channel-schemas.md): Get a distribution channel's schemas by ID. - [Get Distribution Channel Versions](https://docs.b-bot.space/mainapi-reference/distribution-channels/get-distribution-channel-versions.md): Get all versions of a distribution channel. - [Set Latest Distribution Channel Version](https://docs.b-bot.space/mainapi-reference/distribution-channels/set-latest-distribution-channel-version.md): Set the latest version for a distribution channel. - [Knowledge Domains: List Documents](https://docs.b-bot.space/mainapi-reference/knowledge-domains/list-documents.md): List documents in a knowledge domain, including extracted entities and relationships. - [Knowledge Domains: List Entities](https://docs.b-bot.space/mainapi-reference/knowledge-domains/list-entities.md): List entities extracted from a knowledge domain container. - [Knowledge Domains: List Relationships](https://docs.b-bot.space/mainapi-reference/knowledge-domains/list-relationships.md): List relationships inferred between entities in a knowledge domain. - [Get All Experts](https://docs.b-bot.space/mainapi-reference/experts/get-experts.md): Retrieve all experts associated with the authenticated user. Only available for Agencies and Middleware Partners. - [Get Expert by ID](https://docs.b-bot.space/mainapi-reference/experts/get-expert-by-id.md): Retrieve a specific expert by its ID. Only available for Agencies and Middleware Partners. - [Create Expert](https://docs.b-bot.space/mainapi-reference/experts/create-expert.md): Create a new expert in the B-Bot system. Only available for Agencies and Middleware Partners. - [Update Expert (PUT)](https://docs.b-bot.space/mainapi-reference/experts/update-expert.md): Update an existing expert's configuration using PUT. Only available for Agencies and Middleware Partners. - [Delete Expert](https://docs.b-bot.space/mainapi-reference/experts/delete-expert.md): Permanently delete an expert from the system. This action is irreversible. Only available for Agencies and Middleware Partners. - [Get Template Experts](https://docs.b-bot.space/mainapi-reference/experts/get-template-experts.md): Retrieve publicly available expert templates for installation. Only available for Agencies and Middleware Partners. - [Create Thread](https://docs.b-bot.space/mainapi-reference/threads/create-thread.md): Create a thread. - [Search Threads](https://docs.b-bot.space/mainapi-reference/threads/search-threads.md): Search for threads. - [Count Threads](https://docs.b-bot.space/mainapi-reference/threads/count-threads.md): Get the count of threads matching the specified criteria. - [Get Thread State](https://docs.b-bot.space/mainapi-reference/threads/get-thread-state.md): Get state for a thread. - [Update Thread State](https://docs.b-bot.space/mainapi-reference/threads/update-thread-state.md): Add state to a thread. - [Get Thread State At Checkpoint](https://docs.b-bot.space/mainapi-reference/threads/get-thread-state-at-checkpoint.md): Get state for a thread at a specific checkpoint. - [Get Thread State At Checkpoint](https://docs.b-bot.space/mainapi-reference/threads/get-thread-state-at-checkpoint-1.md): Get state for a thread at a specific checkpoint. - [Get Thread History](https://docs.b-bot.space/mainapi-reference/threads/get-thread-history.md): Get all past states for a thread. - [Get Thread History Post](https://docs.b-bot.space/mainapi-reference/threads/get-thread-history-post.md): Get all past states for a thread. - [Copy Thread](https://docs.b-bot.space/mainapi-reference/threads/copy-thread.md): Create a new thread with a copy of the state and checkpoints from an existing thread. - [Get Thread](https://docs.b-bot.space/mainapi-reference/threads/get-thread.md): Get a thread by ID. - [Delete Thread](https://docs.b-bot.space/mainapi-reference/threads/delete-thread.md): Delete a thread by ID. - [Patch Thread](https://docs.b-bot.space/mainapi-reference/threads/patch-thread.md): Update a thread. - [Join Thread Stream](https://docs.b-bot.space/mainapi-reference/threads/join-thread-stream.md): This endpoint streams output in real-time from a thread. The stream will include the output of each run executed sequentially on the thread and will remain open indefinitely. It is the responsibility of the calling client to close the connection. - [List Runs](https://docs.b-bot.space/mainapi-reference/thread-runs/list-runs.md): List runs for a thread. - [Create Background Run](https://docs.b-bot.space/mainapi-reference/thread-runs/create-background-run.md): Create a run in existing thread, return the run ID immediately. Don't wait for the final run output. - [Create Run, Stream Output](https://docs.b-bot.space/mainapi-reference/thread-runs/create-run-stream-output.md): Create a run in existing thread. Stream the output. - [Create Run, Wait for Output](https://docs.b-bot.space/mainapi-reference/thread-runs/create-run-wait-for-output.md): Create a run in existing thread. Wait for the final output and then return it. - [Get Run](https://docs.b-bot.space/mainapi-reference/thread-runs/get-run.md): Get a run by ID. - [Delete Run](https://docs.b-bot.space/mainapi-reference/thread-runs/delete-run.md): Delete a run by ID. - [Join Run](https://docs.b-bot.space/mainapi-reference/thread-runs/join-run.md): Wait for a run to finish. - [Join Run Stream](https://docs.b-bot.space/mainapi-reference/thread-runs/join-run-stream.md): Join a run stream. This endpoint streams output in real-time from a run similar to the /threads/__THREAD_ID__/runs/stream endpoint. If the run has been created with `stream_resumable=true`, the stream can be resumed from the last seen event ID. - [Cancel Run](https://docs.b-bot.space/mainapi-reference/thread-runs/cancel-run.md) - [Cancel Runs](https://docs.b-bot.space/mainapi-reference/thread-runs/cancel-runs.md): Cancel one or more runs. Can cancel runs by thread ID and run IDs, or by status filter. - [Create Run, Stream Output](https://docs.b-bot.space/mainapi-reference/stateless-runs/create-run-stream-output.md): Create a run in a new thread, stream the output. - [Create Run, Wait for Output](https://docs.b-bot.space/mainapi-reference/stateless-runs/create-run-wait-for-output.md): Create a run in a new thread. Wait for the final output and then return it. - [Create Background Run](https://docs.b-bot.space/mainapi-reference/stateless-runs/create-background-run.md): Create a run in a new thread, return the run ID immediately. Don't wait for the final run output. - [Create Run Batch](https://docs.b-bot.space/mainapi-reference/stateless-runs/create-run-batch.md): Create a batch of runs in new threads, return immediately. - [Retrieve a single item.](https://docs.b-bot.space/mainapi-reference/store/retrieve-a-single-item.md) - [Store or update an item.](https://docs.b-bot.space/mainapi-reference/store/store-or-update-an-item.md) - [Delete an item.](https://docs.b-bot.space/mainapi-reference/store/delete-an-item.md) - [Search for items within a namespace prefix.](https://docs.b-bot.space/mainapi-reference/store/search-for-items-within-a-namespace-prefix.md) - [List namespaces with optional match conditions.](https://docs.b-bot.space/mainapi-reference/store/list-namespaces-with-optional-match-conditions.md) - [A2A Post](https://docs.b-bot.space/mainapi-reference/a2a/a2a-post.md): Communicate with an assistant using the Agent-to-Agent Protocol. Sends a JSON-RPC 2.0 message to the assistant. - [MCP Get](https://docs.b-bot.space/mainapi-reference/mcp/mcp-get.md): Implemented according to the Streamable HTTP Transport specification. - [MCP Post](https://docs.b-bot.space/mainapi-reference/mcp/mcp-post.md): Implemented according to the Streamable HTTP Transport specification. Sends a JSON-RPC 2.0 message to the server. - [Terminate Session](https://docs.b-bot.space/mainapi-reference/mcp/terminate-session.md): Implemented according to the Streamable HTTP Transport specification. Terminate an MCP session. The server implementation is stateless, so this is a no-op. - [Server Information](https://docs.b-bot.space/mainapi-reference/system/server-information.md): Get server version information, feature flags, and metadata. - [System Metrics](https://docs.b-bot.space/mainapi-reference/system/system-metrics.md): Get system metrics in Prometheus or JSON format for monitoring and observability. - [Health Check](https://docs.b-bot.space/mainapi-reference/system/health-check.md): Check the health status of the server. Optionally check database connectivity. ## OpenAPI Specs - [fastapi](https://docs.b-bot.space/docs/fastapi.json) - [openapi](https://docs.b-bot.space/api-reference/openapi.json) ## Optional - [Documentation](https://docs.b-bot.space) - [Academy](https://academy.b-bot.space) - [Community](https://chat.whatsapp.com/G29HAcsk0rU2ZeAElznxQ0) - [Dev-Blog](https://beyond-bot.ai/blogs/developer-blog)