Skip to main content
GET
List messages

Authorizations

Authorization
string
header
required

Use a workspace API key in the Authorization header. Keys use pk_live_<key_id> for production and pk_test<key_id>_ for test mode.

Path Parameters

conversationId
string
required
Example:

"conv_x6q5vl75f5d53m7oet2k4r5w6a"

Query Parameters

visibility
enum<string>
default:all

Filter by the internal flag. Use public for a customer-facing view that excludes internal notes.

Available options:
all,
public,
internal
limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string

Opaque keyset cursor from a prior response's nextCursor. Omit for the first page. Malformed or tampered cursors return 400.

Response

Messages in chronological order.

data
object[]
required
hasMore
boolean
required

True when more rows exist beyond this page.

nextCursor
string | null

Opaque cursor for the next page. Pass it as the cursor query param. Null when hasMore is false.