Skip to content
Everruns Everruns

create_call

POST
/v1/sessions/{session_id}/voice/calls
 
curl --request POST \
  --url https://app.everruns.com/api/v1/sessions/example/voice/calls \
  --header 'Content-Type: application/json' \
  --data '{ "instructions": "Always confirm before placing an order.", "model": "gpt-realtime", "reasoning_effort": "medium", "voice": "alloy", "sdp": "example" }'

Create a voice call attached to the session.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
session_id
required
string

Request Body required

Section titled “Request Body required ”
Media type application/json

Request body for voice call.

object
instructions

Extra system instructions appended to the realtime session prompt.

string | null
Example 
Always confirm before placing an order.
model

Provider-side realtime model identifier. When omitted the server picks the agent’s configured default.

string | null
Example 
gpt-realtime
reasoning_effort

Reasoning effort hint passed through to the realtime model. One of low, medium, high. When omitted the server picks the provider’s default.

string | null
Example 
medium
voice

Realtime voice preset (provider-specific). When omitted the server picks the agent’s configured default.

string | null
Example 
alloy
sdp
required
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Realtime WebRTC call created

Media type application/json

Response body for voice call.

object
answer_sdp
required

Server-generated SDP answer to send back to the client to complete the WebRTC handshake.

string
expires_at
required

Timestamp when the call’s lease expires (RFC 3339).

string format: date-time
model
required

Provider-side model identifier used for the realtime session.

string
provider
required

Realtime provider routing this connection.

string
provider_call_id

Provider-side call identifier once issued. None until the realtime call is established.

string | null
reasoning_effort
required

Reasoning effort tier for thinking-capable models.

string
voice
required

Realtime voice preset selected for the connection.

string
voice_connection_id
required

Prefixed public identifier of the voice connection. See ID Schema.

string
Example generated
{
  "answer_sdp": "example",
  "expires_at": "2026-04-15T12:00:00Z",
  "model": "example",
  "provider": "example",
  "provider_call_id": "example",
  "reasoning_effort": "example",
  "voice": "example",
  "voice_connection_id": "example"
}