Skip to main content
POST
Save realtime conversation

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
sessionId
string

Realtime session ID. For OpenAI GPT-Live, the session id returned by /rtSession — the voice minutes are billed only for a session the server started for this user.

inputs
string[]

User inputs from the session

outputs
string[]

AI outputs from the session

tools
object[]

Tools used during the session

usage
object

Token usage for the session

sdkTranscriptOrigin
string

Browser origin of the page that received this session's live transcript through the iframe SDK (audit; empty when none did)

provider
string

Voice provider that ran the session (anam_pria_custom_llm, cartesia, google_cli, xai_cli, openai_live). Persisted as the record's rtProvider so readers label the model by lane; omitted by OpenAI Realtime, which the server derives from the twin's rtModel.

voiceSeconds
number

OpenAI GPT-Live only — cumulative voice seconds reported by the session. The server bounds it to the time since the session started and bills only the seconds not billed by an earlier save.

Response

Conversation saved successfully

success
boolean
historyId
string

ID of the saved history record