切换机器人禁用状态

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.

POST /api/bots/toggle-disabled

Toggle bot disabled state

cURL

curl --request POST \
  --url http://localhost:8080/api/bots/toggle-disabled \
  --header 'Authorization: Bearer <token>'

200

{
  "id": 123,
  "token": "<string>",
  "name": "<string>",
  "source": "cli",
  "manage_enabled": true,
  "proxy_enabled": true,
  "backend_url": "<string>",
  "secret_token": "<string>",
  "long_poll_enabled": true,
  "description": "<string>",
  "running": true,
  "webhook_mode": true,
  "disabled": true
}

授权

BearerAuthCookieAuth

Authorization · string · header · 必填

API key with bmx_ prefix. Obtain via /api/auth/api-keys.

查询参数

id · integer · 必填

Bot ID to toggle

响应

200

application/json

Updated bot configuration with the new disabled state

id · integer

Unique bot ID

token · string

Telegram bot token

name · string

Display name

source · enum<string>

Registration source (informational only — both types are functionally identical)

可用选项: cli, web

manage_enabled · boolean

Whether chat management features are active for this bot

proxy_enabled · boolean

Whether this bot forwards updates to a backend URL

backend_url · string

Backend URL to forward updates to (when proxy_enabled)

secret_token · string

Secret token for validating backend webhook requests

long_poll_enabled · boolean

Whether the long-poll endpoint buffers updates for this bot

description · string

Natural-language description used by the LLM router

running · boolean

Whether the bot is currently active (polling or webhook-registered)

webhook_mode · boolean

Whether the bot is in webhook mode (not polled by BotMux)

disabled · boolean

Whether the bot is disabled. Disabled bots are stopped and do not poll or receive webhook updates.