GET
/
conversations
/
{conversation_id}
/
events
Stream conversation events
curl --request GET \
  --url https://api.operator.xyz/conversations/{conversation_id}/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Operator-Version: <operator-version>'
{
  "id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "agent_id": "<string>",
  "livemode": true,
  "conversation_id": "<string>",
  "payload": {},
  "experimental": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Operator-Version
enum<string>
required

The API version to use.

Available options:
2025-06-19

Path Parameters

​
conversation_id
string
required

Unique identifier for the conversation, e.g. conv_8qm9JBCiTe7.

Response

Successful response.

Events emitted by the agent system in response to client input or internal agent logic.

Typically the conversation begins with a setup when the agent fetches the conversation context and initializes.

The conversation's 'start' and 'end' indicate the live session's bounds - when the user was actively connected through phone or chat. In case of an async chat the bounds are determined automatically.

User's and agent's messages are recorded as they are processed by the agent. Agent's speech is streamed as partial updates, terminated with a final message. User's messages are captured as a single event.

​
id
string
required

Unique identifier for the event, e.g. ev_8qm9JBCiTe7.

​
created_at
string<date-time>
required

When the event was created.

​
agent_id
string
required

Version-specific identifier for the agent that handled the conversation, e.g. ca_8qm9JBCiTe7@v0.

​
livemode
boolean
required

Whether the conversation is in livemode.

​
conversation_id
string
required

Unique identifier for the conversation, e.g. conv_8qm9JBCiTe7.

​
payload
object
required

Check out the Conversation events documentation page for the full description of the payload types.

​
experimental
boolean
required

Whether this event is experimental.