HTTP API
VoiceSessionRecord
The summary record of a real-time voice connection.
Shape: object
| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
id |
yes | string (uuid) |
The connection’s identifier. | — |
tenantId |
yes | string |
The tenant. Resolved when the connection is established and fixed for the connection’s lifetime. | — |
sessionId |
yes | string |
The identifier of the agent session the conversation runs in. | — |
agentName |
yes | string |
The name of the agent being talked to. | — |
startedAt |
yes | string (date-time) |
The moment the connection opened. | — |
endedAt |
no | string (date-time) |
The moment the connection closed; null while still open. |
— |
turns |
no | integer (int32) |
The number of completed conversation turns. | pattern `^-?(?:0\ |
inputSeconds |
no | number (double) |
The total resolved audio duration (seconds). Stays null if the provider does not report duration — Tracon does not fabricate a duration. |
pattern `^-?(?:0\ |
outputChars |
no | integer (int64) |
The total characters synthesized to speech. | pattern `^-?(?:0\ |
endReason |
no | null oneOf VoiceSessionEndReason |
— | — |
createdBy |
no | string |
The actor who opened the connection. | — |
provider |
no | string |
The provider that hosted the conversation, e.g. openai; null when Tracon ran the conversation itself. |
— |
model |
no | string |
The model the conversation ran on; null when unknown. |
— |
liveSeconds |
no | number (double) |
The billable wall-clock duration of a provider-hosted live session, in seconds. | pattern `^-?(?:0\ |
cost |
no | null oneOf VoiceSessionCost |
— | — |