GET
Get Conversation

Authorizations

Authorization
string
header
required

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

Path Parameters

conversation_id
string<uuid>
required

Response

Successful Response

One conversation, and the contact it belongs to.

id identifies THIS conversation. contact_key identifies the caller or endpoint it is with, and is shared by every conversation with them - use it to list a contact's whole history (GET /v1/conversations?contact_key=…).

agent_id
string<uuid> | null
required
agent_name
string | null
required
contact_key
string | null
required
created_at
string<date-time>
required
id
string<uuid>
required
last_message_at
string<date-time> | null
required
last_message_text
string | null
required
metadata
Metadata · object
required
ref
ConversationRefSummary · object | null
required

The contact this conversation belongs to: key, binding, and what we know.

summary
string | null
required
surface
string | null
required
updated_at
string<date-time>
required
userdata
Userdata · object
required
vars
Vars · object
required