Get one conversation
Endpoints
Get a conversation
Full timeline for one conversation: messages, no-reply expirations, label changes.
GET
Get one conversation
events[] is a discriminated-union timeline. The discriminator is
always type. Today the union includes:
To pull just the messages from the timeline:
Snapshot, not subscription
This endpoint serves a fresh snapshot every call, off the materialized state inside the durable object that owns the conversation. There is no “give me the diff since last read” — and you don’t need one. The pattern we want you to use is:- Events stream tells you something changed on
convId X. - GET /conversations/:convId gives you the current state.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identity handle, URL-encoded.
Example:
"alice.acme@inboxbase.ai"
Conversation id.
Pattern:
^conv_[0-9a-f]+$