AI

Get one AI conversation

The caller's stored conversation, reconstructed from its durable event history. With known_seq and known_version equal to the stored ones the body says not_modified and carries no turns. With an older known_seq only the turns past it come back, plus earlier turns whose status changed since known_version; with the same seq but another version, every turn does.

get/api/{org_id}/ai/chats/{session_id}

Request

Path parameters

org_idstring required

Organization name

session_idstring required

Chat session ID

Query parameters

known_seqinteger

Sequence of the caller's cached copy

known_versionstring

state_version of the caller's cached copy

limitinteger

At most this many turns, the newest

Response

The conversation

agent_typestring required
created_atinteger required

Microseconds since the epoch.

forked_from_sharestring nullable

Set on a chat forked from a share: the share's id.

last_committed_seqinteger required

Highest durably stored event sequence (-1: nothing yet).

session_idstring required
titlestring required
updated_atinteger required
active_turnboolean required

A turn of this chat is running right now.

has_moreboolean required

Older turns were left out to honour limit.

not_modifiedboolean required

True when known_seq and known_version are current; turns is then omitted.

partial_from_seqinteger nullable

Set when turns holds the turns past this seq plus older ones whose status changed.

state_versionstring required

Changes whenever the committed seq, a turn's status or error, or active_turn changes.

turnsobject[] nullable

Per turn: the user's words, the UI frames, and turn_id/status/error_code if recorded.

Changes

No recorded changes to this operation across all 1 revision of this API.