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