Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Query Parameters

chatId
string<uuid>
required

Unique identifier of the chat to retrieve history for

limit
number

Optional page size for paginated history fetch (1-100)

Required range: 1 <= x <= 100
beforeCursor
string

Cursor for loading older events

Pattern: ^\d+:[0-9a-fA-F-]{36}$

Response

Successful response

Chat history response containing events and chat metadata

events
object[]
required

Array of chat event objects

A chat event that can be one of many types: chat messages, tool usage, status updates, artifacts, etc. Each event has a discriminator field "type" that determines its structure.

chat
object | null
required

Chat details or null if not found

feedbackByEvent
object

Latest human thumb feedback keyed by chat event id

nextCursor
string | null

Cursor for loading older events

Pattern: ^\d+:[0-9a-fA-F-]{36}$
hasMore
boolean

Whether more older events are available