Calls

Create and manage voice calls

Create voice call

post

Create a voice call session for BYOT (Bring Your Own Telephony) users.

Supports multiple connection types:

• twilio - For Twilio WebSocket connections (default)

• telnyx - For Telnyx telephony provider

• plivo - For Plivo telephony provider

• websocket - For custom WebSocket connections with configurable sample rates

Returns a WebSocket URL that can be used with the specified telephony provider.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Body

application/json

agentIdstringRequired

The ID of the agent to use for this call

connectionTypestring · enumOptional

The telephony provider connection type

Default: twilioPossible values:

Responses

201

Call created successfully

application/json

400

Bad request - Invalid parameters

application/json

401

Unauthorized - Invalid or missing API key

application/json

402

Payment Required - Insufficient balance

application/json

404

Agent not found

application/json

500

Internal server error

application/json

post

/calls/create

HTTPcURLJavaScriptPython

POST /api/v1/calls/create HTTP/1.1
Host: dashboard.omnia-voice.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "agentId": "agent-123"
}

Twilio connection (default)Telnyx connectionCustom WebSocket connection

{
  "id": "text",
  "websocketUrl": "https://example.com",
  "status": "created",
  "connectionType": "webrtc",
  "agent": {
    "id": "text",
    "name": "text",
    "description": "text"
  },
  "createdAt": "2026-02-08T10:08:29.925Z"
}

Create inline voice call

post

Create a voice call session with inline configuration (no pre-created agent required).

This endpoint allows stateless integration where all configuration is passed directly in the request body, including system prompt, voice, and optional tools.

Use Cases:

• Quick prototyping without creating agents

• Dynamic agent configurations

• Serverless integrations

Supports multiple connection types:

• webrtc - For browser-based WebRTC calls

• twilio - For Twilio WebSocket connections

• telnyx - For Telnyx telephony provider

• plivo - For Plivo telephony provider

• websocket - For custom WebSocket connections

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Body

application/json

Request body for creating a call with inline configuration (no agent required)

systemPromptstringRequired

The base system prompt for the agent

voicestringRequired

Voice name (e.g., "Mark", "Sarah")

languagestringRequired

Language code (e.g., "en", "es", "fr")

greetingstringRequired

Greeting message for the agent

modelstringOptional

LLM model to use

temperaturenumber · max: 1Optional

LLM temperature (0-1). Default is 0.

Default: 0

firstSpeakerstring · enumOptional

Who speaks first. Default is 'agent'.

Default: agentPossible values:

interruptiblebooleanOptional

Whether agent's speech can be interrupted. Default is false.

Default: false

maxDurationinteger · min: 60 · max: 7200Optional

Maximum call duration in seconds. Default is 3000 (50 min).

Default: 3000

inactivityTimeoutinteger · min: 10 · max: 300Optional

Seconds of silence before inactivity action

inactivityActionstring · enumOptional

Action when inactivity timeout is reached

Possible values:

recordingEnabledbooleanOptional

Whether to record the call

Default: true

connectionTypestring · enumOptional

Connection type for the call

Default: twilioPossible values:

Responses

201

Call created successfully

application/json

400

Bad request - Missing required fields

application/json

401

Unauthorized

application/json

402

Payment Required - Insufficient balance

application/json

500

Internal server error

application/json

post

/calls/inline

HTTPcURLJavaScriptPython

POST /api/v1/calls/inline HTTP/1.1
Host: dashboard.omnia-voice.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 273

{
  "systemPrompt": "You are a helpful customer support agent. Be friendly and professional.",
  "voice": "Mark",
  "language": "en",
  "greeting": "Hello! Thanks for calling. How can I help you today?",
  "firstSpeaker": "agent",
  "temperature": 0.3,
  "maxDuration": 1800,
  "connectionType": "webrtc"
}

Agent speaks firstUser speaks firstWith custom tools

{
  "id": "text",
  "websocketUrl": "https://example.com",
  "status": "created",
  "connectionType": "webrtc",
  "agent": {
    "id": "text",
    "name": "text",
    "description": "text"
  },
  "createdAt": "2026-02-08T10:08:29.925Z"
}