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", "provider_id": "prov_01h…", "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
provider_id

Realtime provider binding: the prefixed public id of the provider connection to route this voice connection through (e.g. prov_…). Lets an org with more than one realtime-capable provider pick which one serves the connection. When omitted, the server resolves the org’s default (or single) realtime provider. The bound provider’s driver MUST declare the realtime service, otherwise the request is rejected with 400.

string | null
Example 
prov_01h…
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"
}