Skip to main content
POST
Create WebSocket session
The connection URL is single-use and expires after 300 seconds by default. Keep it private. See the WebSocket guide to connect.

Authorizations

Authorization
string
header
required

API key in the format: Bearer YOUR_KARTA_API_KEY.

Headers

X-Request-ID
string

Optional request-tracing identifier.

Body

application/json
agent_id
string
required

Live voice agent ID returned by List agents.

Minimum string length: 1
llm_dynamic_variables
object | null

Prompt variables for this session; defaults to an empty object.

agent_override
object

Invalid overrides are ignored and reported in warnings.

Response

Session created.

signed_url
string<uri>

Single-use WebSocket connection URL.

warnings
object[]