Skip to main content
GET
Get conversation history

Authorizations

Authorization
string
header
required

Tenant API key with cxm:conversations.write, cxm:conversations.*, cxm:write, or cxm:* scope. Keep it in a trusted backend; do not expose it in browser code.

Path Parameters

tenantId
string
required

Exact tenant-authorized ID without path separators.

Required string length: 1 - 128
conversationId
string
required

Exact tenant-authorized ID without path separators.

Required string length: 1 - 512

Query Parameters

limit
integer
default:100

Maximum records in this page. Smaller pages can occur because of History byte limits.

Required range: 1 <= x <= 200
cursor
string

Opaque nextCursor from a previous page for this tenant and Conversation.

Minimum string length: 1

Response

Conversation read completed.

items
object[]
required

Oldest-first stored messages and events, including internal notes. Existing History redaction and size limits apply; records expose redactedPaths, truncatedFields, and sourceByteSizes.

Maximum array length: 200
nextCursor
string | null
required

Opaque continuation cursor; pass it unchanged as cursor on the next request. Null means no further page was found.