Skip to main content
GET
Page conversation history

Authorizations

Authorization
string
header
required

A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

Path Parameters

id
string
required

Operator conversation identifier.

Minimum string length: 1

Query Parameters

before
integer

Return events before this event ID. Requires through; before without through is invalid_request.

Required range: x >= 0
through
integer

Return events at or before this event ID: the stream_cursor of the first page. Omitted, it is the current stream cursor. Above the current stream cursor is invalid_request.

Required range: x >= 0
limit
integer

Maximum number of events, before live events are joined; the first page also holds the rest of a running turn.

Required range: 1 <= x <= 100

Response

A page of conversation events.

events
object[]
required
has_more_before
boolean
required
next_before
integer
required
Required range: x >= 0
stream_cursor
integer
required

The conversation's newest event id in this snapshot. Open live_url with after=<stream_cursor> to continue after it.

Required range: x >= 0
live_url
string<uri>
required

The conversation's live stream, a WebSocket. Connect with ?after=: this history's stream_cursor, or to resume, the id of the last event or up_to_date received. Send Authorization: Bearer and no Origin header. Each message is a JSON object with a type. {"type":"hello"} comes first. {"type":"event","event":{...}} carries an OperatorEvent, whose id is the one this history uses: apply events in id order and show an event seen in both once. A snapshot replaces the live text of its block, a tool_end the live output of its call, and an attempt_reset drops the live content its turn showed before it. {"type":"up_to_date","id":} means every event the stream holds was sent. The last message says what to do next: {"type":"reconnect"} connect again after the last id received; {"type":"reset"} the stream no longer holds what follows your cursor: read this history again and connect after its stream_cursor; {"type":"gone"} the conversation was deleted.