API Reference

Initiate a WebRTC Call

Creates a LiveKit room, dispatches an AI agent, and returns connection credentials for your client SDK.

Endpoint

POST /v1/assistants/{assistant_uuid}/initiate-call

assistant_uuid

string

required

UUID of the assistant to connect to

Authentication

Requires a Bearer token in the Authorization header. Use an API key from Developer → API Keys or a session JWT.

Authorization: Bearer YOUR_API_KEY

Response

{
  "success": true,
  "data": {
    "session_id": "550e8400-e29b-41d4-a716-446655440000",
    "room_name": "test-668a5015-e94c-4769-9180-72dff89ee9f4-42",
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "livekit_url": "wss://your-livekit-instance.livekit.cloud"
  }
}

Field	Type	Description
`session_id`	string	UUID for tracking this session. Use when ending the call.
`room_name`	string	LiveKit room name. Passed to the client SDK automatically.
`token`	string	LiveKit access token with `room_join` and `can_publish` grants.
`livekit_url`	string	WebSocket URL of the LiveKit server.

Pass token and livekit_url directly to any LiveKit client SDK:

import { Room } from "livekit-client";
const room = new Room();
await room.connect(data.livekit_url, data.token);

Workflow variant

POST /v1/workflows/{workflow_uuid}/initiate-call

mode

string

required

Either "draft" (current unpublished state) or "published" (latest published version)

Same response shape as the assistant endpoint.

Example

curl -X POST https://api.vonative.com/v1/assistants/668a5015-e94c-4769-9180-72dff89ee9f4/initiate-call \
  -H "Authorization: Bearer YOUR_API_KEY"

End a WebRTC Call

Endpoint

POST /v1/sessions/{session_id}/end

Example

curl -X POST https://api.vonative.com/v1/sessions/550e8400-e29b-41d4-a716-446655440000/end \
  -H "Authorization: Bearer YOUR_API_KEY"

Errors

Status	Code	Description
`402`	`insufficient_credits`	Account has zero or negative credit balance
`404`	`not_found`	Assistant UUID not found or not accessible
`429`	`too_many_concurrent_calls`	Plan’s concurrent call limit reached
`500`	`livekit_error`	LiveKit room creation failed

Getting Started

Assistants

WebRTC & LiveKit

Workflows

Phone Numbers

Tools

Developer

Billing

Monitoring

API Reference

API Reference

Initiate a WebRTC Call

Endpoint

Authentication

Response

Workflow variant

Example

End a WebRTC Call

Endpoint

Example

Errors

Next steps

Web Quickstart

Mobile & Native

​API Reference

​Initiate a WebRTC Call

​Endpoint

​Authentication

​Response

​Workflow variant

​Example

​End a WebRTC Call

​Endpoint

​Example

​Errors

​Next steps

Web Quickstart

Mobile & Native

API Reference

Initiate a WebRTC Call

Endpoint

Authentication

Response

Workflow variant

Example

End a WebRTC Call

Endpoint

Example

Errors

Next steps