Create Realtime Session
POST
Python
Authorizations
Project API key (sk-kupe-...) or a Supabase user JWT.
Body
application/json
Existing agent id. Alias: id.
Agent name. Reuses a live agent with this name, or creates one.
Alias for agent_id.
Voice name or voice id. Alias: voice_id.
Alias for voice — library voice_id or row id.
System prompt. Alias: instructions.
Spoken first message. Alias: greetings.
OpenAI-style function tools, or webhook/MCP tools (http_url / type=mcp).
MCP server(s): {url, headers?, tools?} where tools are names or full defs.
- Mcp · object
- Mcp · object[]
Response
Successful Response

