Skip to main content
POST
Save (upsert) a chat thread

Authorizations

X-API-Key
string
header
required

Body

application/json

Upsert payload — the client's conversation id plus its full transcript.

public_id
string
required

Client-minted conversation id (the #c= URL hash). Unique per user; upserts overwrite.

Required string length: 1 - 32
transcript
Transcript · object
required

The full conversation (frontend StoredConversation shape): messages, results, suggestedRefinements, sessionId, lastUserMessage. Capped at 256 KB.

Response

OK

A full thread, including the transcript needed to resume it.

public_id
string
required

The thread's conversation id.

title
string
required

Short title for the thread.

transcript
Transcript · object
required

Full conversation transcript (StoredConversation shape).

modified
string<date-time>
required

Last-updated timestamp (ISO 8601).