Cossistant Logocossistant

Get conversation timeline items

arrow-leftPreviousNextarrow-right

Fetch paginated timeline items (messages and events) for a conversation in chronological order.

GET
/v1/conversations/{conversationId}/timeline

Authorization

Path Parameters

conversationIdstring

The ID of the conversation

Query Parameters

limit?number

Number of timeline items to fetch per page

Default50
Range1 <= value <= 100
cursor?string

Cursor for pagination (timestamp_id format from previous response)

Header Parameters

X-Public-Key?string

Public API key for browser-based authentication.

Match^pk_(live|test)_[a-f0-9]{64}$
X-Visitor-Id?string

Visitor ID from localStorage.

Match^[0-9A-HJKMNP-TV-Z]{26}$

Response Body

application/json

application/json

curl -X GET "https://api.cossistant.com/v1/v1/conversations/string/timeline"
{
  "items": [
    {
      "id": "string",
      "conversationId": "string",
      "organizationId": "string",
      "visibility": "public",
      "type": "message",
      "text": "string",
      "tool": "string",
      "parts": [
        {
          "type": "text",
          "text": "string"
        }
      ],
      "userId": "string",
      "aiAgentId": "string",
      "visitorId": "string",
      "createdAt": "string",
      "deletedAt": "string"
    }
  ],
  "nextCursor": "string",
  "hasNextPage": true
}
{
  "error": "string"
}
arrow-left Mark a conversation as seen by the visitor POSTReport a visitor typing state POST arrow-right