Skip to main content
POST
Create Session

Authorizations

Authorization
string
header
required

Project API key (sk-kupe-...) or a Supabase user JWT.

Body

application/json
org_id
string | null
project_id
string | null
llm_id
string | null
stt_id
string | null
tts_id
string | null
agent_id
string | null
post_call_analysis_ids
string[] | null
variables
Variables · object | null
channel
enum<string>
default:web
Available options:
web,
telephony
provider
enum<string> | null
Available options:
twilio,
plivo,
exotel
record
boolean
default:true

Response

Successful Response

session_id
string<uuid>
required
org_id
string
required
project_id
string
required
channel
string
required
direction
enum<string>
required
Available options:
web,
inbound,
outbound
transport
string
required
status
string
required
llm_id
string
required
stt_id
string
required
tts_id
string
required
created_at
string<date-time>
required
provider
string | null
room_name
string | null
started_at
string<date-time> | null
ended_at
string<date-time> | null
user_identifier
string | null
ended_by
string | null
failure_reason
string | null
hangup_reason
string | null
language
string | null
message_count
integer
default:0
duration_seconds
number | null
agent_duration_seconds
number | null
transfer_duration_seconds
number | null
avg_agent_latency_ms
number | null
avg_user_latency_ms
number | null
attempt_number
integer
default:1
goal_status
string | null
agent_id
string | null
ws_url
string | null
token
string | null

Short-TTL LiveKit participant JWT. Never logged.

media_ws_url
string | null

Provider media WebSocket URL for telephony sessions.

ws_ticket
string | null

Single-use telephony media-stream connect ticket. Never logged.