Your AI team, working in Bolna

Create conversational voice agents using Bolna AI to enhance interactions, streamline operations and automate support.

Start your company

What your team can do in Bolna

102 tools to work with, connected with an API key.

Abort workflow campaign

Move a running or paused campaign to the terminal aborted state and stop its executions. Campaign flow is draft -> running <-> paused -> aborted; aborted campaigns cannot resume or be deleted.

Add custom LLM model

Register an OpenAI-compatible custom LLM endpoint with Bolna.

Add number to SIP trunk

Add a DID phone number to a SIP trunk.

Add Provider to Bolna

Tool to add a new telephony or voice service provider to your Bolna account. Use when you need to configure API keys for providers like Twilio, Deepgram, or ElevenLabs before creating agents.

Bulk create dispositions

Atomically create multiple dispositions linked to one agent.

Buy phone number

Purchase an available phone number in the US or India with a recurring account charge.

Cancel workflow execution

Stop one workflow execution before its next external action.

Copy Bolna Agent

Tool to create a duplicate copy of an existing Bolna voice AI agent. Use when you need to replicate an agent's complete configuration (tasks, prompts, LLM settings, etc.) with a new name.

Create Bolna Batch

Tool to create a new outbound calling batch by uploading a CSV of contacts to obtain a batch_id. Use real, allocatable E.164 numbers; trial accounts can call only phone numbers verified with Bolna. Follow with BOLNA_SCHEDULE_BATCH_BY_ID to schedule execution.

Create Bolna Knowledgebase

Tool to create a new knowledgebase for Voice AI agents to reference during conversations. Use when you need to provide agents with domain-specific knowledge from PDFs or web URLs. Note: Initially returns status 'processing'; poll or wait for status to become 'processed' before use.

Create Bolna Voice AI Agent (v2)

Tool to create a new Bolna Voice AI agent using the v2 API. Use when you need to set up a new conversational agent from scratch with custom LLM, synthesizer, transcriber, and task configurations. This fills the gap for end-to-end agent setup in workflows starting from an empty account state.

Create disposition

Create a structured transcript extraction disposition linked to an agent.

Create extraction category

Create an extraction category on an agent.

Create SIP trunk

Create a bring-your-own-telephony SIP trunk.

Create sub-account

Create an enterprise sub-account with its own concurrency limits and API key.

Create Template Agent

[DEPRECATED] Attempt to create an agent through Bolna's undocumented template endpoint. Use BOLNA_CREATE_AGENT for current integrations.

Create workflow

Create an empty, unpublished workflow and return its identifier.

Create workflow campaign

Create a draft campaign pinned to a published workflow version.

Delete agent by id

Permanently delete a Voice AI agent and all associated data including batches, executions, and configurations

Delete batch by id

Permanently delete a batch campaign by its ID, removing it from the system. This operation cannot be undone.

Delete custom LLM model

Delete a custom LLM model and its stored endpoint key from Bolna.

Delete disposition

Permanently delete a disposition without changing past call results.

Delete extraction category

Permanently delete an extraction category and every disposition inside it.

Delete Knowledgebase

Tool to permanently delete a knowledgebase from your Bolna account. Use when you need to remove an existing RAG knowledgebase that is no longer needed. This operation cannot be undone.

Delete phone number

Permanently release a purchased phone number and stop recurring billing.

Delete SIP trunk

Permanently delete a SIP trunk and its gateways, IP identifiers, and numbers.

Delete sub-account

Permanently delete a sub-account and all of its data.

Delete workflow

Permanently delete a workflow, its draft, and all published versions.

Delete workflow campaign

Permanently delete an empty campaign only while it is draft or scheduled. Running, paused, aborted, and implicit campaigns created by RUN_WORKFLOW cannot be deleted.

Fetch all batches by agent idReads only

Retrieve all batches associated with a specific Bolna Voice AI agent. Returns a comprehensive list of batches with details including batch status (scheduled, created, queued, executed), creation and scheduled times, contact counts, file names, and execution status breakdown. Use this to monitor batch campaigns, track their progress, and manage outbound calling operations for the agent.

Get Agent (v1 - Deprecated)Reads only

[DEPRECATED] Retrieve Voice AI agent details using the v1 API endpoint. Use GET /v2/agent/{agent_id} (retrieve_agent_by_id) instead for current implementations. This action returns agent configuration including name, type, status, tasks, and prompts.

Get all agentsReads only

Retrieve all agents configured in your Bolna account Returns a comprehensive list of all voice agents with their configurations including: - Agent metadata (ID, name, type, status) - Task configurations (conversation settings, toolchains) - AI model settings (LLM, transcriber, synthesizer) - Webhook and phone number assignments - System prompts and guardrails This is useful for listing available agents, checking agent configurations, or finding specific agents by their properties.

Get all sub-accounts usageReads only

Retrieve usage and cost breakdowns for every organization sub-account.

Get dispositionReads only

Retrieve one disposition, optionally requiring an agent link.

Get execution by idReads only

Retrieve detailed information about a specific phone call execution by its ID. Returns comprehensive execution data including conversation transcript, duration, costs (LLM, TTS, STT, network, platform), telephony details (phone numbers, recording URL, provider info), usage metrics (tokens, characters, duration), and extracted structured data. Use this to: - Analyze individual call performance and outcomes - Access conversation transcripts and recordings - Review cost breakdowns and resource usage - Monitor call status and error messages - Retrieve extracted structured data from conversations

Get execution raw logsReads only

Retrieve raw transcriber, LLM, synthesizer, and telephony logs for a call.

Get knowledgebase by IDReads only

Tool to retrieve details of a specific knowledgebase by its ID. Returns complete configuration including processing status, file information, vector ID, and embedding parameters (chunk size, similarity top k, overlapping). Use when you need to check if a knowledgebase has finished processing or to inspect its configuration before using it with an agent.

Get SIP trunkReads only

Retrieve full details of one SIP trunk.

Get sub-account usageReads only

Retrieve one sub-account's usage and cost breakdown for up to 32 days.

Get User InformationReads only

Tool to retrieve information about the authenticated user. Use when you need details like name, email, wallet balance, or concurrency limits for the current user.

Get workflowReads only

Retrieve workflow status, live settings, and version history.

Get workflow campaignReads only

Retrieve a campaign with entry-status and validation-error counts.

Get workflow campaign entries templateReads only

Get the exact CSV header expected by a campaign's pinned workflow version.

Get workflow campaign reportReads only

Get aggregate statuses, termination reasons, and per-node funnel counts.

Get workflow draftReads only

Retrieve a workflow's editable draft definition and revision.

Get workflow executionReads only

Retrieve one contact's status, node attempts, state, and recent timeline.

Get workflow versionReads only

Retrieve a specific published workflow version and its full node graph.

Import Bolna Agent

Tool to import an existing Bolna voice AI agent by its ID. Use when you need to copy or duplicate an agent configuration, create a new agent from a template, or migrate an agent from another environment.

List agents (paginated)Reads only

Retrieve a paginated list of Bolna agents, optionally filtered by user or sub-account. This action is deprecated.

List all phone numbersReads only

Tool to list all phone numbers associated with your Bolna account. Use when you need to retrieve details of all phone numbers including provider, associated agent, pricing, and rental status.

List all providersReads only

Retrieve all providers associated with your Bolna account Returns a list of all configured providers including: - Provider IDs (unique identifiers) - Provider names (e.g., API key types) - Masked provider values (secrets) - Creation timestamps (both absolute and human-readable) Use this when you need to view all configured API providers, check provider details, or verify provider setup in your Bolna account.

List available voicesReads only

List available voices for a TTS provider, model, and language, with pagination. The API requires provider_id, model_id, and language; page sizes are limited to 100. Legacy user_id and is_api_request inputs are accepted but ignored.

List custom LLM modelsReads only

List custom LLM models available in the current Bolna account scope.

List dispositionsReads only

List account-owned dispositions or dispositions linked to one agent.

List extraction categoriesReads only

List an agent's extraction categories and the dispositions inside each.

List KnowledgebasesReads only

List knowledgebases in your Bolna account, with optional status filtering and pagination. Results include processing status and other knowledgebase details.

List numbers on SIP trunkReads only

List all phone numbers assigned to a SIP trunk.

List SIP trunksReads only

List SIP trunks, optionally filtered by active status.

List sub-accountsReads only

List all sub-accounts linked to the organization.

List TTS providers and modelsReads only

List TTS providers and models supported for a language.

List violationsReads only

List flagged call violations, optionally filtered by status.

List workflow campaign entriesReads only

List a campaign's uploaded contacts, including row validation failures.

List workflow campaign executionsReads only

List and filter the per-contact executions created by a campaign.

List workflow campaignsReads only

List workflow campaigns with filters, sorting, and offset pagination.

List workflow node typesReads only

List workflow node types and their supported configuration fields.

List workflowsReads only

List account workflows with optional name filtering and offset pagination.

Make an outbound phone call from agent

Initiate an outbound phone call using a configured Bolna Voice AI agent. The agent will call the specified recipient and engage in a conversation based on its configured prompt and capabilities.

Partially Update Bolna Voice AI Agent (v1)

Tool to partially update a Voice AI agent using the v1 API endpoint. Use when you need to modify specific agent properties like name, welcome message, webhook URL, synthesizer settings, or system prompts without providing the full configuration. Note: This is a deprecated v1 endpoint; prefer using PATCH /v2/agent/{agent_id} for new implementations.

Patch Bolna Voice AI agent (v2)

Partially update a Bolna v2 agent without replacing its full configuration.

Pause workflow campaign

Move a scheduled or running campaign to paused; only paused campaigns can be resumed, while aborted campaigns are terminal.

Publish workflow

Freeze the current valid draft as a new immutable workflow version.

Remove number from SIP trunk

Remove a phone number and any agent mapping from a SIP trunk.

Remove Provider from Bolna Account

Tool to remove a provider from your Bolna account by its key name. Use when you need to delete a provider configuration that is no longer needed or needs to be replaced.

Rename workflow

Rename an existing workflow.

Resend workflow execution webhook

Queue redelivery of a finished workflow execution's original webhook.

Resume workflow campaign

Move a paused campaign back to running. Draft or scheduled campaigns must be started, and aborted campaigns cannot be resumed.

Retrieve agent by idReads only

Retrieve details for a specific Bolna voice AI agent by ID, including name, type, status, tasks, timestamps, and the first task's prompt when available.

Retrieve agent execution detailsReads only

Retrieve details of a specific agent execution, including transcript, costs, duration, status, and telephony data when available. This action is deprecated.

Retrieve agent execution statusReads only

Retrieve a paginated, filterable list of executions for a specific agent, including call status, costs, transcripts, and telephony data when available. When both date bounds are supplied, their range cannot exceed seven days.

Retrieve Batch Details by IDReads only

Retrieve comprehensive details about a specific Bolna batch by its ID. Returns batch metadata including creation time, execution status, scheduled time, contact statistics, and call status breakdown. Use this to monitor batch progress or retrieve information about previously created batch calling campaigns.

Retrieve batch execution listReads only

Retrieve a page of executions from a specific batch. Results may include conversation metrics, transcripts, costs, and resource usage breakdowns, along with pagination information.

Run workflow

Run one contact through the workflow's latest published version.

Save workflow draft

Overwrite a workflow draft using revision-based optimistic concurrency.

Schedule Batch by ID

Schedule a batch to execute at a specific time. After creating a batch with BOLNA_CREATE_BATCH, use this action to set when the batch calls should begin. The batch must exist and be in a schedulable state (e.g., 'created' or 'stopped').

Search available phone numbersReads only

Search for available phone numbers to purchase for Bolna Voice agents in the US or India, with an optional prefix pattern.

Setup inbound call for agent

Add agent for inbound calls

Start workflow campaign

Move a draft or scheduled campaign to running. It must contain at least one valid pending entry; a campaign whose entries all failed validation cannot start.

Stop Agent Calls

Stop queued or scheduled calls for a specific Voice AI agent, optionally filtered by user or sub-account.

Stop batch by id

Stop a running batch by its ID. This halts all queued calls in the batch. Any calls currently in the queue waiting to be executed will be cancelled and will not be processed. Use this when you need to immediately halt a batch campaign that's in progress.

Stop queued or scheduled call

Cancel a queued or scheduled call before it starts.

Submit violation

Submit evidence for a Bolna violation and move it to submitted state.

Test dispositions against a transcript

Run every linked disposition against a transcript. Bolna invokes an LLM, so this can take tens of seconds.

Test workflow webhook

Send a sample terminal execution event to a workflow's saved webhook.

Unlink inbound agent

Remove automatic inbound agent routing from a phone number.

Update Bolna Voice AI Agent (v2)

Tool to update all settings and configuration of an existing Bolna Voice AI agent using the v2 API. Use when you need to modify an agent's full configuration including LLM settings, synthesizer, transcriber, tasks, prompts, or any other agent property. This performs a complete update (PUT operation).

Update disposition

Partially update a disposition, with optional agent-scoped copy-on-write.

Update extraction category

Rename an extraction category and/or change its extraction model.

Update SIP trunk

Partially update a SIP trunk; supplied gateway arrays replace existing arrays.

Update sub-account

Partially update an enterprise sub-account's name or concurrency limits.

Update workflow settings

Apply an RFC 7396 merge patch to a workflow's live settings.

Upload workflow campaign entries

Upload JSON contacts to a draft, scheduled, or running workflow campaign. The result reports accepted and failed rows, including per-row failures and warnings.

Validate workflowReads only

Check a saved workflow draft for errors and warnings before publishing.

More in AI agents

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or