Create a voice Session: a short-lived, single-conversation reservation that lets a client hold a live voice chat with your agent. This is step 1 of 2. Creating the Session does not start any audio on its own; it returns a ws_url that a client then connects to over WebSocket to actually talk.

Call this endpoint from your server with your API key, and return only the ws_url to your client. The API key must never reach the browser. The ws_url is the only thing the client needs, and it is safe to hand out because it is single-use and expires. For how to connect and talk, see "Connect the client and talk" below the request details.

(Tags: Sessions)

Retrieve all agents for the authenticated user with pagination support. (Tags: Agents)

Create a new agent with the provided configuration. The full config supports transcriber, model, voice, web search, transfer, end-call conditions, post-call actions (email + webhook), ambient background track, initial ringing sound, and multilingual support.

Voicemail detection is an access-gated feature that we turn on per account. If it isn't enabled for yours yet, request access before configuring the voicemail object.

(Tags: Agents)

Get details of a specific agent by ID. The response also includes a version_history_enabled boolean showing whether version history is turned on for the agent's organization. (Tags: Agents)

Update an existing agent. Send only the fields you want to change.

Voicemail detection is an access-gated feature that we turn on per account. If it isn't enabled for yours yet, request access before configuring the voicemail object below. (Tags: Agents)

Permanently delete an agent. (Tags: Agents)

List an agent's saved versions, newest first. Includes manual (named) versions, automatic versions, and system backups taken before a restore. (Tags: Agents)

Save the agent's current configuration as a named version. (Tags: Agents)

Delete a saved version. (Tags: Agents)

Rename a saved version or edit its note. Version history is immutable otherwise; only the name and note can change. (Tags: Agents)

Get a record-level diff for this version. By default it shows what changed in this version compared with the version before it. Use against=current to compare with the agent's live config (what restoring this version would change), or against=<number> to compare with another version. (Tags: Agents)

Restore a version onto the live agent. Your current setup is saved first as a backup version, so restoring is undoable. Configuration is brought back; any knowledge files or integrations that were deleted since this version was saved can't be re-linked, and are reported in skipped. (Tags: Agents)

Initiate a call to a phone number using a specified agent. The phone number must include a country code with a leading plus.

(Tags: Calls)

Retrieve call logs with pagination and optional filtering. (Tags: Calls)

Detailed information about a specific call (duration, status, transcript, sentiment, extracted variables). (Tags: Calls)

List bulk-call campaigns with pagination and optional status filter. (Tags: Bulk calls)

Create a new bulk-call campaign. Supports immediate, scheduled, and auto-retry modes.

There are two kinds of campaign:

• Static (default): you supply the full contact_list up front and the campaign dials through it.

• Dynamic: set is_dynamic to true and the campaign accepts contacts in real time via the Add contact to dynamic campaign webhook. contact_list is optional here, so you can start the campaign empty and feed it from a CRM, form, or automation. A dynamic campaign stays alive waiting for contacts instead of completing when its queue drains.

(Tags: Bulk calls)

Push a single contact into a dynamic bulk-call campaign in real time. Dynamic campaigns are created from the dashboard (Bulk Call

Create New Campaign > Dynamic Campaign) and stay alive waiting for contacts, so this webhook is how you feed them from a CRM, form, or automation platform. The contact is queued immediately, and the campaign starts calling it as soon as it is within operating hours.

(Tags: Bulk calls)

Get detailed information about a bulk-call campaign. (Tags: Bulk calls)

Pause, resume, or reschedule a running campaign. (Tags: Bulk calls)

Cancel a bulk-call campaign. (Tags: Bulk calls)

Real-time status of a running bulk-call campaign. (Tags: Bulk calls)

List all knowledge-base files for the authenticated user. (Tags: Knowledge base)

Check whether a file can be uploaded based on size and type. (Tags: Knowledge base)

Upload a PDF file. The file content must be Base64 encoded. (Tags: Knowledge base)

Attach multiple knowledge-base files to an agent. (Tags: Knowledge base)

Detach multiple knowledge-base files from an agent. (Tags: Knowledge base)

Permanently delete a file. Removes it from any attached agents. Cannot be undone. (Tags: Knowledge base)

Retrieve all phone numbers associated with your account. (Tags: Phone numbers)

Attach an account-owned phone number to an existing agent. (Tags: Phone numbers)

Detach a phone number from its associated agent. (Tags: Phone numbers)

Import an existing Twilio number by providing your Twilio credentials. (Tags: Phone numbers)

Import an Exotel number by providing your Exotel credentials. (Tags: Phone numbers)

Import a phone number associated with a SIP trunk. (Tags: Phone numbers)

Retrieve all available Large Language Model providers. (Tags: Providers)

Retrieve voices with filtering and pagination support. ElevenLabs supports advanced filtering by name, language, accent, and gender. Other providers support basic pagination only.

(Tags: Providers)

Retrieve all Speech-to-Text providers. (Tags: Providers)

Retrieve all Text-to-Speech providers. (Tags: Providers)

Comprehensive response with services and voices in one payload. (Tags: Providers)

Detailed metadata for a specific voice. (Tags: Providers)

List all child organizations and their users under the reseller account. Returns each organization's balance, cost-per-minute rate, and concurrency limit, plus the dashboard menu access flags scoped to your reseller's permissions for every user.

(Tags: Reseller)

Create a new child user and organization under the reseller. The new organization is linked to your reseller account automatically.

(Tags: Reseller)

Enable or disable dashboard menu access flags for a child user. Only the flags you pass are changed. Flags outside your reseller's permissions are silently ignored.

(Tags: Reseller)

Set or remove the expiry date on a child user. The user must belong to a child organization of your reseller.

(Tags: Reseller)

Set the maximum number of simultaneous calls a child organization can run. Slots come from the reseller's shared pool. Increasing the limit deducts the delta from your pool and fails if you don't have enough slots. Decreasing the limit returns the delta to your pool immediately.

(Tags: Reseller)

Preview the cost of a transfer or revert without moving any credits. Use this to confirm amounts before calling the transfer or revert endpoints. The response shape differs between forward transfers and reverts. See the examples.

(Tags: Reseller)

Transfer minutes from the reseller balance to a child organization. Credits are deducted from your balance immediately on success. The target organization must be a direct child of your reseller. Use the calculate endpoint first to preview the cost.

(Tags: Reseller)

Take back unused minutes from a child organization to the reseller balance. The refund is calculated at the child's current rate, so you don't pass one. This matches exactly what was originally charged. Use the calculate endpoint first to preview the refund.

(Tags: Reseller)

Paginated history of all credit transfers and reverts for the reseller account. Returns reverse-chronological order by default. Date filters are inclusive.

(Tags: Reseller)