AI

Read a shared AI conversation

The conversation behind a share link, cut at the share's sequence. With known_seq and known_version equal to the current seq and state_version the body says not_modified and carries no turns.

get/api/{org_id}/ai/shared/{token}

Request

Path parameters

org_idstring required

Organization name

tokenstring required

Share token

Query parameters

known_seqinteger

Sequence of the caller's cached copy

known_versionstring

state_version of the cached copy

Response

The shared conversation

active_turnboolean required

A turn of a live share is running; poll until it is false.

created_atinteger required

When the chat was started (micros).

modestring required
not_modifiedboolean required

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

owner_namestring nullable

The owner's display name; never their email on a public link.

redact_toolsboolean required

Tool inputs and outputs are left out of turns.

seqinteger required

Last committed event the share shows; pass back as known_seq.

shared_atinteger required

When the share was created (micros).

state_versionstring required

Changes with seq, turn statuses and share settings; send back as known_version.

titlestring required
truncatedboolean required

The oldest turns were left out to keep the response within the server's size cap.

turnsobject[] nullable

Same shape as GET /ai/chats/{session_id} returns, without user_message_id.

Changes

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