Skip to content
Everruns Everruns

attach_call

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

Attach an external voice call to the session.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
session_id
required
string
voice_connection_id
required
string

Request Body required

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

Request body for voice attach.

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
provider_call_id
required
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Realtime sideband attached

Media type application/json

Response body for voice attach.

object
expires_at
required

Timestamp when the connection’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
required

Provider-side call identifier of the connected realtime call.

string
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
{
  "expires_at": "2026-04-15T12:00:00Z",
  "model": "example",
  "provider": "example",
  "provider_call_id": "example",
  "reasoning_effort": "example",
  "voice": "example",
  "voice_connection_id": "example"
}