# BotMux

## Docs

- [Demote Admin](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/admins/demote.md): Removes all admin rights from a user.
- [List Admins](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/admins/list.md): Returns the current administrator list for a chat as reported by Telegram.
- [Promote User](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/admins/promote.md): Grants admin rights with specified permissions to a user. The bot must be admin with promote permission.
- [Set Admin Title](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/admins/title.md): Sets a custom title (badge) for an admin user in a chat.
- [Chat Statistics](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/analytics/stats.md): Returns message counts, active user stats, and activity metrics for a chat.
- [Audit Log](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/audit-log/list.md): Returns a paginated list of administrative actions performed in a chat.
- [Add Bot](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/bots/add.md): Registers a new Telegram bot. The token is validated with Telegram before saving. Admin only.
- [Delete Bot](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/bots/delete.md): Removes a bot and all associated data. Admin only.
- [Check Health](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/bots/health.md): Pings the configured backend URL for the specified bot and returns its health status.
- [List Bots](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/bots/list.md): Returns all registered bots with their current running status and configuration.
- [Toggle bot disabled](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/bots/toggle-disabled.md): Toggles whether a bot is disabled. A disabled bot is fully stopped — it does not poll for updates, does not receive webhook updates, and its managed Bot instance is removed. Calling this endpoint again re-enables the bot and restarts it. Admin only.
- [Update Bot](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/bots/update.md): Updates settings for an existing bot. Admin only.
- [Validate Token](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/bots/validate.md): Calls `getMe` on Telegram to verify the token is valid and returns bot info.
- [Delete Chat](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/chats/delete.md): Removes a chat and all its messages from BotMux tracking. Does not affect the actual Telegram chat.
- [List Chats](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/chats/list.md): Returns all chats tracked by a specific bot.
- [Refresh Chat](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/chats/refresh.md): Fetches fresh chat metadata from Telegram and updates the database.
- [Poll Updates](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/long-polling/poll.md): Long-polling endpoint that returns buffered Telegram updates in `getUpdates`-compatible format.
- [Delete Message](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/messages/delete.md): Deletes a message from Telegram. The bot must have delete permission.
- [List Messages](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/messages/list.md): Returns paginated messages for a chat.
- [Pin Message](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/messages/pin.md): Pins a message in a chat. The bot must have pin permission.
- [Search Messages](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/messages/search.md): Full-text search within a chat's message history.
- [Send Message](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/messages/send.md): Sends a message via the specified bot to the specified chat. Optionally replies to an existing message.
- [Unpin Message](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/messages/unpin.md): Unpins a specific message in a chat.
- [Add Route](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/routes/add.md): Creates a new message routing rule. Admin only.
- [Delete Route](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/routes/delete.md): Removes a routing rule. Admin only.
- [List Routes](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/routes/list.md): Returns all message routing rules for a bot.
- [Update Route](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/routes/update.md): Modifies an existing routing rule. Admin only.
- [Add Tag](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/tags/add.md): Assigns a tag to a user in a chat.
- [List Tags](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/tags/list.md): Returns all tags applied to users in the specified chat.
- [Remove Tag](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/tags/remove.md): Deletes a tag by its record ID.
- [User Tags](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/tags/user-tags.md): Returns all tags assigned to a specific user in a chat.
- [Telegram API Proxy](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/telegram-proxy/proxy.md): Transparent proxy to api.telegram.org with message capture and method interception
- [Ban User](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/users/ban.md): Bans a user from the specified chat. The bot must have ban permission.
- [List Users](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/users/list.md): Lists users who have sent messages in a chat, with optional search.
- [Unban User](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/api-reference/users/unban.md): Lifts a ban on a user in the specified chat.
- [Data Flow](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/architecture/data-flow.md): How updates flow through BotMux
- [Architecture](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/architecture/overview.md): BotMux system architecture and code organization
- [Storage](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/architecture/storage.md): SQLite database schema and storage model
- [API Keys](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/auth/api-keys.md): Programmatic access with Bearer token authentication
- [Authentication](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/auth/overview.md): Session-based authentication with roles and API keys
- [Users & Roles](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/auth/users-and-roles.md): Role-based access control with bot-level permissions
- [Protocol Bridges](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/bridges/overview.md): Bridge external messaging protocols to Telegram bots
- [Slack Bridge](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/bridges/slack.md): Native Slack integration with Events API and Web API
- [Webhook Bridge](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/bridges/webhook.md): Generic HTTP webhook bridge for any protocol
- [Bot Setup](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/concepts/bot-setup.md): Creating and configuring a Telegram bot for BotMux
- [How It Works](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/concepts/how-it-works.md): Understanding BotMux's core architecture and update flow
- [Multi-Bot Management](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/concepts/multi-bot.md): Managing multiple Telegram bots from a single BotMux instance
- [CLI Flags](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/configuration/cli-flags.md): Command-line flags for configuring BotMux
- [Custom Telegram API](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/configuration/custom-telegram-api.md): Use a self-hosted Telegram Bot API server
- [Demo Mode](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/configuration/demo-mode.md): Isolated demo environments for public demonstrations
- [Environment Variables](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/configuration/environment-variables.md): Configure BotMux via environment variables
- [Requirements](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/deployment/requirements.md): System requirements for running BotMux
- [Resource Requirements](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/deployment/resource-requirements.md): CPU, RAM, and disk requirements
- [Security](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/deployment/security.md): Security considerations for production deployment
- [Docker](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/docker.md): Run BotMux with Docker and Docker Compose
- [Admin Actions](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/admin-actions.md): Chat administration through the web UI
- [Analytics](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/analytics.md): Chat statistics and activity insights
- [API Proxy](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/api-proxy.md): Transparent Telegram API proxy that captures outgoing bot messages
- [Audit Log](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/audit-log.md): Track all admin actions performed through the web UI
- [Internationalization](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/i18n.md): Multi-language interface support
- [Long Polling](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/long-polling.md): Telegram-compatible getUpdates endpoint for pull-based integrations
- [Media Support](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/media-support.md): Inline rendering of photos, videos, stickers, and more
- [Message Monitoring](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/message-monitoring.md): Real-time message collection and search
- [Reverse Proxy](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/reverse-proxy.md): Forward Telegram updates to legacy webhook backends
- [User Tags](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/features/user-tags.md): Custom classification system for chat members
- [Introduction](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/index.md): BotMux — web-based command center for managing Telegram bots
- [Installation](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/installation.md): Build and install BotMux from source
- [Quick Start](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/quickstart.md): Get BotMux running in under 5 minutes
- [Inter-Bot Routing](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/routing/inter-bot-routing.md): Route messages between bots based on configurable conditions
- [LLM Routing](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/routing/llm-routing.md): AI-based smart routing via any OpenAI-compatible API
- [Source-NAT](https://botmux-mintlify-api-updates-1776816558.mintlify.app/docs/en/routing/source-nat.md): Bidirectional return path for routed messages