POST
Start a simulated call

Authorizations

Authorization
string
header
required

Sign in from your terminal with the OAuth device flow (see the Authentication page for a copy-paste block), or grab your current session token from https://console.silmo.ai/api/auth/token while signed in to the console. Access tokens are short-lived (a few minutes) — refresh with your refresh_token. Everything a session produces is stored and served strictly within your organization's namespace.

Body

application/json
personaId
string
required

A persona id from GET /meta.

tool
enum<string>

checklist = screening · dst = full assessment · fast-track = urgent pathway

Available options:
checklist,
dst,
fast-track
prePopulate
boolean
default:true

Read the persona's referral evidence pack into a briefing first, so the interviewer goes into the call already briefed and references the records by name during the call.

fromSessionId
string<uuid>

Chaining: the id of a completed, positive Checklist session. Its results are injected as referral evidence for this DST.

maxTurns
integer

Hard cap on conversation turns. Defaults to a realistic per-tool budget.

brisk
boolean
default:false

Generate a short showcase call (~5 minutes): tighter turn budget and pacing overrides for both agents.

template
boolean
default:false

Mark the finished session as a pre-built template, surfaced on the console's start page.

transcriptionEngine
string

Engine for the post-call diarized transcription pass.

Response

The simulated session.

sessionId
string<uuid>
personaId
string
tool
enum<string>

checklist = screening · dst = full assessment · fast-track = urgent pathway

Available options:
checklist,
dst,
fast-track
maxTurns
integer
prePopulate
boolean