Channels API

curl http://localhost:7432/api/v1/channels

{
  "channels": [
    {
      "name": "telegram",
      "status": "connected",
      "unread": 3,
      "messages_total": 1204,
      "last_message_at": "2026-08-08T14:22:00Z"
    },
    {
      "name": "discord",
      "status": "connected",
      "unread": 0,
      "messages_total": 87,
      "last_message_at": "2026-08-08T12:10:00Z"
    },
    {
      "name": "slack",
      "status": "disconnected",
      "unread": 0,
      "messages_total": 0,
      "last_message_at": null
    }
  ]
}

curl http://localhost:7432/api/v1/channels/telegram

{
  "name": "telegram",
  "status": "connected",
  "config": {
    "enabled": true,
    "reply_mode": "direct",
    "rate_limit_per_minute": 30
  },
  "stats": {
    "messages_in_total": 1204,
    "messages_out_total": 1198,
    "errors_total": 2
  }
}

curl -X POST http://localhost:7432/api/v1/channels/telegram/enable
# { "enabled": true }

curl -X POST http://localhost:7432/api/v1/channels/telegram/disable
# { "disabled": true }

curl -X POST http://localhost:7432/api/v1/channels/telegram/reconnect
# { "reconnecting": true }

curl "http://localhost:7432/api/v1/channels/telegram/messages?limit=20"

{
  "messages": [
    {
      "id": "msg-123",
      "direction": "in",
      "text": "What time is it?",
      "user": "user-456",
      "timestamp": "2026-08-08T14:20:00Z"
    },
    {
      "id": "msg-124",
      "direction": "out",
      "text": "It's 2:20 PM UTC.",
      "timestamp": "2026-08-08T14:20:01Z"
    }
  ],
  "total": 1204
}

curl -X PATCH http://localhost:7432/api/v1/channels/telegram/mark-read
# { "marked_read": 3 }