Bolna for AI agents
Agents read Bolna at once. Changes and sends are held for a person's approval by default.
About Bolna
Create conversational voice agents using Bolna AI to enhance interactions, streamline operations and automate support.
What an agent can do in Bolna
Every Bolna action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Bolna without asking first. 41 actions.
- Get all sub-accounts usageRetrieve usage and cost breakdowns for every organization sub-account.
- Get dispositionRetrieve one disposition, optionally requiring an agent link.
- Get execution raw logsRetrieve raw transcriber, LLM, synthesizer, and telephony logs for a call.
- Get knowledgebase by IDTool 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, similarit
- Get SIP trunkRetrieve full details of one SIP trunk.
- Get sub-account usageRetrieve one sub-account's usage and cost breakdown for up to 32 days.
- Get User InformationTool to retrieve information about the authenticated user. Use when you need details like name, email, wallet balance, or concurrency limits for the current user.
- List custom LLM modelsList custom LLM models available in the current Bolna account scope.
- List dispositionsList account-owned dispositions or dispositions linked to one agent.
- List extraction categoriesList an agent's extraction categories and the dispositions inside each.
- List KnowledgebasesTool to retrieve all knowledgebases from your Bolna account. Use when you need to view available RAG knowledgebases, check their processing status, or find specific knowledgebases by status.
- List all phone numbersTool 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.
Show all 41
- List all providersRetrieve 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 prov
- List SIP trunksList SIP trunks, optionally filtered by active status.
- List sub-accountsList all sub-accounts linked to the organization.
- List numbers on SIP trunkList all phone numbers assigned to a SIP trunk.
- Test dispositions against a transcriptRun every linked disposition against a transcript. Bolna invokes an LLM, so this can take tens of seconds.
- Fetch all batches by agent idRetrieve 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 s
- Get all agentsRetrieve 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 configuratio
- Get execution by idRetrieve 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
- Get workflowRetrieve workflow status, live settings, and version history.
- Get workflow campaignRetrieve a campaign with entry-status and validation-error counts.
- Get workflow campaign entries templateGet the exact CSV header expected by a campaign's pinned workflow version.
- Get workflow campaign reportGet aggregate statuses, termination reasons, and per-node funnel counts.
- Get workflow draftRetrieve a workflow's editable draft definition and revision.
- Get workflow executionRetrieve one contact's status, node attempts, state, and recent timeline.
- Get workflow versionRetrieve a specific published workflow version and its full node graph.
- List TTS providers and modelsList TTS providers and models supported for a language.
- List violationsList flagged call violations, optionally filtered by status.
- List available voicesList voices for one TTS provider, model, and language, with pagination. The current API requires provider_id, model_id, and language. Legacy user_id and is_api_request inputs are accepted but ignored;
- List workflow campaign entriesList a campaign's uploaded contacts, including row validation failures.
- List workflow campaign executionsList and filter the per-contact executions created by a campaign.
- List workflow campaignsList workflow campaigns with filters, sorting, and offset pagination.
- List workflow node typesList workflow node types and their supported configuration fields.
- List workflowsList account workflows with optional name filtering and offset pagination.
- Retrieve agent by idRetrieve complete configuration and details for a specific Bolna voice AI agent by its ID. Returns comprehensive agent information including name, type, status, conversation tasks, LLM/synthesizer/tra
- Retrieve agent execution statusRetrieve all executions for a specific agent with pagination and filtering support. Returns a paginated list of agent execution records including call status, cost breakdown, transcripts, and telephon
- Retrieve Batch Details by IDRetrieve 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.
- Retrieve batch execution listRetrieve all executions from a specific batch with pagination support. Returns detailed information about each call execution including conversation metrics, transcripts, costs, and resource usage bre
- Search available phone numbersTool to search for available phone numbers that can be purchased for Bolna Voice agents. Use when you need to find purchasable phone numbers by country or prefix pattern before buying.
- Validate workflowCheck a saved workflow draft for errors and warnings before publishing.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 53 actions.
- Add Provider to BolnaTool 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.
- Add number to SIP trunkAdd a DID phone number to a SIP trunk.
- Bulk create dispositionsAtomically create multiple dispositions linked to one agent.
- Buy phone numberPurchase an available phone number with a recurring account charge.
- Create dispositionCreate a structured transcript extraction disposition linked to an agent.
- Create extraction categoryCreate an extraction category on an agent.
- Create Bolna KnowledgebaseTool 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 retu
- Create SIP trunkCreate a bring-your-own-telephony SIP trunk.
- Create sub-accountCreate an enterprise sub-account with its own concurrency limits and API key.
- Delete custom LLM modelDelete a custom LLM model and its stored endpoint key from Bolna.
- Delete dispositionPermanently delete a disposition without changing past call results.
- Delete extraction categoryPermanently delete an extraction category and every disposition inside it.
Show all 53
- Delete phone numberPermanently release a purchased phone number and stop recurring billing.
- Delete SIP trunkPermanently delete a SIP trunk and its gateways, IP identifiers, and numbers.
- Delete sub-accountPermanently delete a sub-account and all of its data.
- Patch Bolna Voice AI agent (v2)Partially update a Bolna v2 agent without replacing its full configuration.
- Remove number from SIP trunkRemove a phone number and any agent mapping from a SIP trunk.
- Stop queued or scheduled callCancel a queued or scheduled call before it starts.
- Unlink inbound agentRemove 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, trans
- Update dispositionPartially update a disposition, with optional agent-scoped copy-on-write.
- Update extraction categoryRename an extraction category and/or change its extraction model.
- Update SIP trunkPartially update a SIP trunk; supplied gateway arrays replace existing arrays.
- Update sub-accountPartially update an enterprise sub-account's name or concurrency limits.
- Abort workflow campaignMove 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.
- Cancel workflow executionStop one workflow execution before its next external action.
- Copy Bolna AgentTool 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 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
- Create workflowCreate an empty, unpublished workflow and return its identifier.
- Create workflow campaignCreate a draft campaign pinned to a published workflow version.
- Delete agent by idPermanently delete a Voice AI agent and all associated data including batches, executions, and configurations
- Delete batch by idPermanently delete a batch campaign by its ID, removing it from the system. This operation cannot be undone.
- Delete KnowledgebaseTool 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 workflowPermanently delete a workflow, its draft, and all published versions.
- Delete workflow campaignPermanently delete an empty campaign only while it is draft or scheduled. Running, paused, aborted, and implicit campaigns created by RUN_WORKFLOW cannot be deleted.
- Import Bolna AgentTool 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 environme
- Make an outbound phone call from agentInitiate 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.
- Pause workflow campaignMove a scheduled or running campaign to paused; only paused campaigns can be resumed, while aborted campaigns are terminal.
- Publish workflowFreeze the current valid draft as a new immutable workflow version.
- Remove Provider from Bolna AccountTool 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 workflowRename an existing workflow.
- Resend workflow execution webhookQueue redelivery of a finished workflow execution's original webhook.
- Resume workflow campaignMove a paused campaign back to running. Draft or scheduled campaigns must be started, and aborted campaigns cannot be resumed.
- Run workflowRun one contact through the workflow's latest published version.
- Save workflow draftOverwrite a workflow draft using revision-based optimistic concurrency.
- Schedule Batch by IDSchedule 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 s
- Setup inbound call for agentAdd agent for inbound calls
- Start workflow campaignMove 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 CallsTool to stop all queued or scheduled calls for a specific Voice AI agent. Use when you need to immediately halt all pending calls for an agent.
- Stop batch by idStop 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
- Test workflow webhookSend a sample terminal execution event to a workflow's saved webhook.
- Update workflow settingsApply an RFC 7396 merge patch to a workflow's live settings.
- Upload workflow campaign entriesUpload JSON contacts to a draft, scheduled, or running workflow campaign.
Changes wait in Needs you
Changes and sends in Bolna are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Bolna questions
Can an agent change data in Bolna on its own?
Not by default. Changes and sends in Bolna are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Bolna?
This connector lists 41 read actions. Reads run at once, without waiting for approval.
How does Bolna connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.