Skip to main content
GET
List thread messages

Authorizations

Authorization
string
header
required

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

Path Parameters

thread_id
string
required

Query Parameters

limit
integer
Required range: 1 <= x <= 200
cursor
string
order
enum<string>

Sort by created_at. asc returns oldest first (default, matches the conversation timeline); desc returns newest first.

Available options:
asc,
desc
type
enum<string>

Filter to a single channel. email for email replies, slack for Slack and Slack Connect, chat for Microsoft Teams (and any future chat platforms), live_chat for in-app live chat sessions, feedback for the synthesized initial message that the thread was opened with.

Available options:
email,
slack,
chat,
live_chat,
feedback
direction
enum<string>

Filter by message direction. inbound is from the contact, outbound is from your workspace. For live chat, inbound maps to USER messages and outbound to both AGENT and AI.

Available options:
inbound,
outbound
user_id
string

Workspace user id. Filters to outbound messages sent by this user. Live chat messages have no user attribution and are excluded when this is set.

q
string

Case-insensitive substring search across the message body. Searches email subject and text, slack/chat/live-chat text.

Minimum string length: 1
created_after
string<date-time>
created_before
string<date-time>
updated_after
string<date-time>
updated_before
string<date-time>

Response

Successful response

data
object[]
required
page
object
required