Skip to main content
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:
Same idea for filtering to no-reply expirations, label changes, etc.

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.
You never reduce events into your own copy of the thread. We’re the reducer. See Live thread list.

Authorizations

Authorization
string
header
required

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

Path Parameters

handle
string
required

Identity handle, URL-encoded.

Example:

"alice.acme@inboxbase.ai"

convId
string
required

Conversation id.

Pattern: ^conv_[0-9a-f]+$

Response

Conversation snapshot.

identity
string
conversation
object