---
title: "Subscribe to a conversation's live monitor channel"
method: POST
path: "/conversation/{conversationId}/channel/subscribe"
tags: ["Conversation"]
---

# Subscribe to a conversation's live monitor channel

`POST /conversation/{conversationId}/channel/subscribe`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/conversation/{conversationId}/channel/subscribe`
- Auth: HTTP bearer

Subscribe to a conversation to receive a live, curated feed of its
lifecycle events as it runs - message, operation (tool call), completion
and error events - regardless of how the conversation is being executed
(interactive, dispatched, or via an integration such as Slack, Discord
or WhatsApp). High-frequency token events are not included.

This returns a streaming response that stays open until the client
closes it. You can only subscribe to conversations that belong to your
account.

## Parameters

- `#/components/parameters/ConversationId` (unresolved $ref)

## Request body

- object
  - `historyLength` integer: Number of recent monitor events to replay before following live, so a console opening mid-conversation can catch up.

## Response `200`

Successfully subscribed to the conversation monitor channel

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)