Skip to main content
GET
List conversation messages

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Path Parameters

id
string<uuid>
required

Conversation id

Query Parameters

since_seq
integer<int64> | null
turn_id
string<uuid> | null
direction
string | null
view
string | null

?view=admin opts a tenant admin into reading a journal they don't participate in; non-admins are silently downgraded. Same shape as conversation_meta. Honored as read-only - there's no admin-elevation on POST.

Response

The conversation transcript: journal rows, seq-ordered (the cold-load companion to the live SSE stream)

created_at
string<date-time>
required
direction
string
required
id
string<uuid>
required
kind
string
required
payload
any
required
seq
integer<int64>
required
author
null | object

Resolved author for multi-party threads (Slack/Teams): name + public avatar URL, looked up from workspace_users by the message's identity.sub. None for web/extension owners + unknown users -> the frontend falls back to its own current-user rendering.

turn_id
string<uuid> | null