Skip to main content
GET
/
agents
/
{agentId}
/
probe
/
runs
/
{runId}
/
stream
Error
A valid request URL is required to generate request examples
{
  "id": "<string>",
  "conversationId": "<string>",
  "seq": 123,
  "tsMs": 123,
  "payload": {
    "text": "<string>",
    "isFinal": true,
    "language": "<string>",
    "asrConfidence": 123
  },
  "traceId": "<string>"
}

Authorizations

​
Authorization
string
header
required

Clerk JWT (browser). Requires Authorization: Bearer <clerk_jwt> and the X-Organization-Id header. Validated by the ported Clerk middleware, which sets the app.current_organization_id RLS context.

Path Parameters

​
agentId
string
required
​
runId
string
required

Response

SSE stream of probe progress.

The live simulate/chat SSE frame. It IS an AuditEventDTO (UI contract resolution): the SSE event: line equals eventType and the data: line is the AuditEventDTO JSON. Streams terminate with event: done or event: error, consumed via fetch() streaming (Part B Addenda #2).

​
id
string
required
​
conversationId
string
required
​
seq
integer
required
​
tsMs
integer
required
​
channel
enum<string>
required
Available options:
voice,
chat
​
eventType
enum<string>
required

Authoritative AuditEvent / SimulateEvent event-type set (UI contract resolution). Each value selects the per-variant payload shape documented on AuditEventDTO.payload (see the *Payload schemas below). The legacy agent_utterance/turn_summary values are retained additively for the ported audit_events write-path.

Available options:
user_utterance,
agent_message,
tool_call,
kb_retrieval,
guardrail,
verification,
language_switch,
handoff,
barge_in,
latency,
filler,
call_started,
call_ended,
error,
agent_utterance,
turn_summary
​
payload
object
required

Per-eventType payload (see schema description for the eventType→*Payload mapping).

​
traceId
string