# Bland Documentation

Bland is an enterprise voice AI platform for high-volume, regulated, and complex phone workflows. Healthcare networks, insurance carriers, financial services firms, and logistics operators use Bland to build, deploy, and monitor AI voice agents that sound human and operate at scale. Customers include Samsara and a top-10 US bank.

Bland owns the full voice AI stack: telephony, speech-to-text, language model, text-to-speech, and pathway orchestration. The platform delivers sub-400ms response latency, supports up to 1 million concurrent calls, and handles 40+ languages out of the box. Per-minute pricing covers LLM, TTS, STT, and telephony in a single line item, with no per-token charges and no per-feature surcharges. A dedicated Forward Deployed Engineer team builds the customer's first agent end to end.

Bland holds SOC 2 Type II, HIPAA, GDPR, and PCI DSS certifications. Self-hosted and on-premises deployments are available for regulated industries.

## About Bland

- [Bland](https://www.bland.ai): Enterprise voice AI for high-volume, regulated, and complex phone workflows in healthcare, insurance, financial services, and logistics. Customers include Samsara and a top-10 US bank.
- [Bland Voice](https://www.bland.ai/product/bland-voice): AI phone agents for inbound and outbound calls at enterprise scale.
- [Conversational Pathways](https://www.bland.ai/product/conversational-pathways): Visual designer for branching multi-turn phone workflows with state, tool calls, and variable extraction.
- [Use cases](https://www.bland.ai/use-cases/inbound-call-handling): Appointment booking, inbound call handling, financial intakes, logistics ID verification, and other regulated workflows.
- [Pricing](https://www.bland.ai/pricing): Per-minute pricing that bundles LLM, TTS, STT, and telephony with no per-token charges.

## Welcome

- [Welcome to Bland](https://docs.bland.ai/welcome-to-bland.md): Overview of the Bland platform, key capabilities, and links to get started.

## Core Bland Features

- [Conversational Pathways](https://docs.bland.ai/tutorials/pathways.md): Build node-based conversation flows that give your AI agent structured control over dialogue, branching, and actions.
- [Call Logs](https://docs.bland.ai/tutorials/call-logs.md): View, filter, and analyze your call history and transcripts.
- [Custom Twilio Integration](https://docs.bland.ai/tutorials/custom-twilio.md): Connect Bland to your own Twilio account for phone number management.
- [Webhooks](https://docs.bland.ai/tutorials/webhooks.md): Configure outbound API requests inside pathways using the webhook node to retrieve data or trigger workflows during live calls.
- [Tools](https://docs.bland.ai/tutorials/tools/overview.md): Give your AI agent the ability to take actions during live calls by connecting to external APIs and services.
- [Secrets](https://docs.bland.ai/tutorials/secrets.md): Securely store and reference API keys and credentials in your workflows without hardcoding them.
- [Norm](https://docs.bland.ai/tutorials/norm.md): Bland's AI assistant for building, editing, testing, and debugging voice agents from a prompt.

## MCP & AI Agents

- [Bland MCP Server](https://docs.bland.ai/integrations/mcp/overview.md): Connect Claude Code, Cursor, Codex, and any MCP client to your Bland account.
- [MCP: Claude Code](https://docs.bland.ai/integrations/mcp/claude-code.md): Connect Claude Code to your Bland account with one command.
- [MCP: Norm Plugin](https://docs.bland.ai/integrations/mcp/norm.md): Install the Norm plugin for Claude Code to build, test, and ship Bland voice agents from your terminal.
- [MCP: Cursor](https://docs.bland.ai/integrations/mcp/cursor.md): Connect Cursor to your Bland account.
- [MCP: Other Clients](https://docs.bland.ai/integrations/mcp/other-clients.md): Connect Codex, VS Code, Claude Desktop, Windsurf, Gemini CLI, or any MCP client to Bland.
- [MCP: Tool Reference](https://docs.bland.ai/integrations/mcp/tools.md): Every tool exposed by the Bland MCP server.

## Basic Tutorials

- [Batch Calls](https://docs.bland.ai/tutorials/batch-calls.md): Send a batch of calls to a CSV of recipients simultaneously.
- [Tools: Integration Tools](https://docs.bland.ai/tutorials/tools/integration-tools.md): Connect to Cal.com, Salesforce, Slack, and other services using built-in integrations.
- [Tools: Custom API Integration](https://docs.bland.ai/tutorials/tools/custom-api.md): Create tools that call your own backend, internal services, or any HTTP endpoint.

## Advanced Features

- [Testbed](https://docs.bland.ai/tutorials/testbed.md): Iterate on node prompts using real call data and lock in behavior with standards.
- [Scenarios](https://docs.bland.ai/tutorials/scenarios.md): Validate your AI pathways and personas with automated test scenarios.
- [Standards](https://docs.bland.ai/tutorials/standards.md): Node-level regression test framework for locking in expected agent behavior.
- [Evals](https://docs.bland.ai/tutorials/evals.md): Grade real calls for quality at scale using configurable LLM judges.
- [Guard Rails](https://docs.bland.ai/tutorials/guard-rails.md): Automated monitoring that runs continuously on every AI response to catch critical failures before they reach customers.
- [Alerts](https://docs.bland.ai/tutorials/alerts.md): Monitor agent behavior in real time. Configure thresholds on built-in call metrics or define custom conditions, then route notifications to email, phone, or a custom tool.
- [Post Call Webhooks](https://docs.bland.ai/tutorials/post-call-webhooks.md): Trigger HTTP requests after a call ends to process transcripts, sync CRM data, or kick off downstream workflows.
- [Webhook Signing](https://docs.bland.ai/tutorials/webhook-signing.md): Verify the authenticity of Bland webhook payloads using HMAC signature validation.
- [Personas](https://docs.bland.ai/tutorials/personas.md): Create unified AI agents that manage phone numbers and use cases. Build once, use everywhere.
- [Web Chat Widget](https://docs.bland.ai/tutorials/chat-widget.md): Embed a voice and chat widget on your website to let visitors speak or chat with your AI agent.
- [Outcomes](https://docs.bland.ai/tutorials/outcomes.md): Combine pathway tags, citations, and call metadata to define what happened on each call.
- [Blocked Numbers](https://docs.bland.ai/tutorials/blocked-numbers.md): Manage and configure blocked phone numbers in the Bland dashboard.
- [Memory](https://docs.bland.ai/tutorials/memories.md): Preserve context across conversations by enabling memory on your pathway or persona.
- [Flex Mode](https://docs.bland.ai/tutorials/flex-mode.md): Let your agent choose where to go next based on the conversation, instead of strictly following the edges between nodes.
- [Live Translation](https://docs.bland.ai/tutorials/translation.md): Stream audio and receive translated audio back in real time.
- [Agent Speech](https://docs.bland.ai/tutorials/agent-speech.md): Control how readily your agent pauses for callers and how quickly it responds after they stop talking.

## Platform Information

- [Static IPs](https://docs.bland.ai/platform/static-ips.md): Source IPs for outbound requests from Bland to customer endpoints.
- [Billing & Plans](https://docs.bland.ai/platform/billing.md): Understand how usage is billed, available plans, and how to manage billing details.

## SDKs & Tools

- [Command Line Interface](https://docs.bland.ai/sdks/cli.md): Manage your Bland account from the terminal: make calls, build and test pathways, configure phone numbers, and more.
- [Web Agent SDK](https://docs.bland.ai/sdks/web-agent-sdk.md): Embed a Bland voice agent into any web application with secure, token-based authentication.

## Bland Enterprise

- [Infrastructure & Releases](https://docs.bland.ai/enterprise-features/infrastructure-and-releases.md): Dedicated infrastructure, version-controlled releases, and canary deployments for enterprise customers.
- [Custom Dialing](https://docs.bland.ai/enterprise-features/custom-dialing.md): Maximize outbound call pickup rates by dynamically selecting the optimal number from your phone number inventory.
- [Citations](https://docs.bland.ai/enterprise-features/citations.md): Extract structured insights from post-call transcripts using custom schemas.
- [Scheduling Node](https://docs.bland.ai/enterprise-features/scheduling-node.md): Enable intelligent meeting scheduling within conversational pathways using webhook integration.
- [Custom Code Node](https://docs.bland.ai/enterprise-features/custom-code-node.md): Execute custom JavaScript code within conversational pathways.
- [Warm Transfer](https://docs.bland.ai/tutorials/warm-transfer.md): Live human agent transfers facilitated by Bland.
- [Messaging](https://docs.bland.ai/tutorials/messaging/overview.md): Run conversational agents over SMS, RCS, and iMessage from one stack, using the same pathways, personas, and memory as voice.
- [Messaging: SMS](https://docs.bland.ai/tutorials/messaging/sms.md): SMS specifics in Bland: A2P registration, bring-your-own-Twilio, and pricing.
- [Messaging: RCS](https://docs.bland.ai/tutorials/messaging/rcs.md): Rich Communication Services: verified business profile, suggested replies, action buttons, cards, and media.
- [Messaging: iMessage](https://docs.bland.ai/tutorials/messaging/imessage.md): Run a branded iMessage agent that can send and receive photos, videos, files, voice memos, and tapbacks.
- [SIP Integration](https://docs.bland.ai/enterprise-features/SIP-integration.md): Configure and manage SIP for call routing to and from Bland, with guided setup, auto-discovery, test calls, and number porting.
- [SSO Support](https://docs.bland.ai/enterprise-features/SSO.md): Configure Single Sign-On using OIDC or SAML 2.0 with your identity provider.
- [JWT Signature Configuration](https://docs.bland.ai/enterprise-features/jwt-authentication.md): Asymmetric JWT signing for enterprise-grade webhook and request authentication.

## API Reference: Basic Tutorials

- [Send Call using Pathways (Simple)](https://docs.bland.ai/api-v1/post/calls-simple-pathway.md): Send an AI phone call using a conversational pathway agent.
- [Send Call With Task (Simple)](https://docs.bland.ai/api-v1/post/calls-simple.md): Send an AI phone call using a task string.

## API Reference: Calls

- [Send Call](https://docs.bland.ai/api-v1/post/calls.md): Send an AI phone call with a custom objective and actions.
- [Analyze Call with AI](https://docs.bland.ai/api-v1/post/calls-id-analyze.md): Analyze a call using questions and goals.
- [Stop Active Call](https://docs.bland.ai/api-v1/post/calls-id-stop.md): End an active phone call by call_id.
- [Listen to Active Call](https://docs.bland.ai/api-v1/post/calls-id-listen.md): Initiate a live listen session for an active call.
- [Stop All Active Calls](https://docs.bland.ai/api-v1/post/calls-active-stop.md): End all active phone calls on your account.
- [Transfer Active Call](https://docs.bland.ai/api-v1/post/calls-active-transfer.md): Transfer an in-progress call to a different phone number.
- [List Calls](https://docs.bland.ai/api-v1/get/calls.md): Returns metadata for each call dispatched by your account.
- [List Active Calls](https://docs.bland.ai/api-v1/get/active.md): Retrieve all currently active (queued and in-progress) calls for your organization.
- [Call Details](https://docs.bland.ai/api-v1/get/calls-id.md): Retrieve detailed information, metadata, and transcripts for a call.
- [Event Stream](https://docs.bland.ai/api-v1/get/event-stream.md): Retrieve the stream of events that occurred during a call.
- [Get Call Recording](https://docs.bland.ai/api-v1/get/calls-id-recording.md): Retrieve an audio stream for a call recording.
- [Get Corrected Transcript](https://docs.bland.ai/api-v1/get/calls-corrected-transcript.md): Get the corrected transcript from a call's recording.
- [Get Post Call Webhook](https://docs.bland.ai/api-v1/get/postcall-webhooks-get.md): Get the post call webhook data for a specific call.
- [Create Post Call Webhook](https://docs.bland.ai/api-v1/post/postcall-webhooks-create.md): Create and send post call webhooks for specified calls.
- [Resend Post Call Webhook](https://docs.bland.ai/api-v1/post/postcall-webhooks-resend.md): Resend post call webhooks for specified calls.

## Bland Speech

- [Welcome to Bland Speech](https://docs.bland.ai/tts/welcome.md): Humanlike text-to-speech built for realtime conversations and streaming LLM output.
- [Realtime TTS Quickstart](https://docs.bland.ai/tts/realtime-quickstart.md): Stream LLM-style text into one WebSocket turn and save the returned PCM audio as a WAV file.
- [Speech Quickstart](https://docs.bland.ai/tts/quickstart.md): Turn a string into an audio file with one request, then move to streaming.
- [Choosing a Voice](https://docs.bland.ai/tts/voices.md): Pick a built-in voice, clone your own, and set its defaults.
- [Writing for Speech](https://docs.bland.ai/tts/writing-for-speech.md): Control pacing, emphasis, numbers, and delivery with text and the two performance controls.
- [Bland TTS](https://docs.bland.ai/sdks/bland-tts.md): A focused TTS and voice toolkit for Bland AI: CLI, Node library, and MCP server in one lightweight package.
- [Realtime TTS Concepts](https://docs.bland.ai/tts/realtime-concepts.md): Understand server-side text buffering, turns, preemption, cancellation, playback queues, and billing.
- [Speech Limits](https://docs.bland.ai/speech/limits.md): Concurrency, voice clone, and professional clone limits for Bland Speech: what they are, how the $5 unlock works, and how to raise them.
- [Speech Studio](https://docs.bland.ai/tts/speech-studio.md): Write, direct, and synthesize speech in the dashboard with the Norm director, performance tags, and a live editor.

### Migrate to Bland Speech

- [Migrate to Bland Speech](https://docs.bland.ai/tts/migrate.md): Move an existing TTS integration to Bland's realtime WebSocket, HTTP, or OpenAI-compatible endpoint.
- [Migrate from ElevenLabs](https://docs.bland.ai/tts/migrations/elevenlabs.md): Move an ElevenLabs streaming TTS client to Bland's realtime WebSocket.
- [Migrate from Cartesia](https://docs.bland.ai/tts/migrations/cartesia.md): Map Cartesia WebSocket contexts and continuations to Bland turns and preemption.
- [Migrate from Deepgram](https://docs.bland.ai/tts/migrations/deepgram.md): Move Deepgram's streaming Speak protocol to Bland realtime turns.
- [Migrate from PlayHT](https://docs.bland.ai/tts/migrations/playht.md): Replace PlayHT WebSocket authentication and request-level synthesis with Bland realtime turns.
- [Migrate from Resemble AI](https://docs.bland.ai/tts/migrations/resemble.md): Move Resemble WebSocket synthesis to Bland's incremental text and turn protocol.
- [Migrate from Google Cloud TTS](https://docs.bland.ai/tts/migrations/google-cloud.md): Replace Google Cloud bidirectional speech synthesis with Bland's realtime WebSocket.
- [Migrate from Amazon Polly](https://docs.bland.ai/tts/migrations/amazon-polly.md): Move Amazon Polly synthesis to Bland HTTP or stream LLM tokens through Bland realtime TTS.

## API Reference: Voices & Text to Speech

Generate speech from text, manage Bland TTS voices, and clone custom voices. The dashboard surface for these APIs lives at app.bland.ai/dashboard/tts.

### Voices

- [List Voices](https://docs.bland.ai/api-v1/get/voices.md): List all voices available to your account.
- [Get Voice](https://docs.bland.ai/api-v1/get/voices-id.md): Get details on a single voice.
- [Get Voice Settings](https://docs.bland.ai/api-v1/get/voices-id-settings.md): Get the synthesis defaults and valid ranges for a voice.
- [Update Voice Settings](https://docs.bland.ai/api-v1/post/voices-id-settings.md): Update consistency/expressiveness defaults on a voice you own.
- [Update Voice Config](https://docs.bland.ai/api-v1/patch/voices-id-config.md): Alias of Update Voice Settings, kept for backwards compatibility.
- [Rename Voice](https://docs.bland.ai/api-v1/patch/voices-id-rename.md): Change the display name of a voice you own.
- [Rate Voice](https://docs.bland.ai/api-v1/post/voices-id-rate.md): Give a voice a 1-5 star rating.
- [Delete Voice](https://docs.bland.ai/api-v1/delete/voices-id.md): Permanently delete a voice you own.

### Speech Generation

- [Realtime Speech (WebSocket)](https://docs.bland.ai/api-v2/post/tts-ws.md): Stream LLM text into one realtime session and receive speech as binary audio frames.
- [Synthesize Speech (HTTP)](https://docs.bland.ai/api-v2/post/tts.md): Generate speech from a complete input string over HTTP.
- [Speech (OpenAI-compatible)](https://docs.bland.ai/api-v2/post/audio-speech.md): Use Bland voices through the OpenAI text-to-speech request and error shapes.

### Streaming

- [Mint Stream Input Token](https://docs.bland.ai/api-v1/post/speak-stream-input-token.md): Short-lived JWT for browser clients to open the streaming WebSocket.

### Discovery

- [Check Voice Name Availability](https://docs.bland.ai/api-v1/post/voices-check-name-availability.md): Check whether a voice name is available before cloning.
- [List Shared Voices](https://docs.bland.ai/api-v1/get/voices-shared.md): Browse the public Bland voice library.
- [Add Library Voice](https://docs.bland.ai/api-v1/post/voices-library-add-id.md): Add a shared library voice to your org.

### Voice Cloning

- [Clone Voice](https://docs.bland.ai/api-v1/post/clone.md): Create a custom voice clone.

### Generation History

- [List TTS Generations](https://docs.bland.ai/api-v1/get/speak-samples.md): List your stored text-to-speech generations.
- [Get TTS Generation](https://docs.bland.ai/api-v1/get/speak-samples-id.md): Retrieve a single stored TTS generation (JSON or raw WAV).

### Models

- [List TTS Models](https://docs.bland.ai/api-v2/get/tts-models.md): List what each TTS model supports.
- [List TTS Models](https://docs.bland.ai/api-v1/get/models.md): List the available Bland TTS models and their capabilities.

### Samples

- [List Voice Samples](https://docs.bland.ai/api-v1/get/voices-id-samples.md): List the training samples attached to a voice clone.
- [Add Voice Sample](https://docs.bland.ai/api-v1/post/voices-samples.md): Append training samples to an existing voice clone.
- [Get Voice Sample](https://docs.bland.ai/api-v1/get/voices-id-samples-sample-id.md): Download a single training sample as audio or JSON.
- [Update Voice Sample Transcriptions](https://docs.bland.ai/api-v1/patch/voices-id-samples.md): Update transcription text on training samples.
- [Delete Voice Samples](https://docs.bland.ai/api-v1/delete/voices-id-samples.md): Remove training samples from a voice clone.

## API Reference: Conversational Pathways

- [Get All Pathways](https://docs.bland.ai/api-v1/get/all_pathway.md): Returns information about all conversational pathways in your account, including nodes and edges.
- [Get Single Pathway](https://docs.bland.ai/api-v1/get/pathway.md): Returns information about a single conversational pathway, including nodes and edges.
- [Get Pathway Session Token](https://docs.bland.ai/api-v1/get/pathway-session.md): Creates a session token for pathway chat access (expires after 1 hour).
- [Create Pathway](https://docs.bland.ai/api-v1/post/pathways.md): Create a new conversational pathway.
- [Update Pathway](https://docs.bland.ai/api-v1/post/update_pathways.md): Update a pathway's fields, including name, description, nodes, and edges.
- [Delete Pathway](https://docs.bland.ai/api-v1/post/delete_pathway.md): Delete a conversational pathway.
- [Generate Pathway](https://docs.bland.ai/api-v1/post/pathway-generate.md): Create an asynchronous pathway generation job from a detailed prompt.
- [Get Pathway Generation Status](https://docs.bland.ai/api-v1/get/pathway-generate-status-job-id.md): Poll generation status and retrieve the generated pathway ID when ready.
- [Create Pathway Chat](https://docs.bland.ai/api-v1/post/pathway-chat-create.md): Create a pathway chat instance for sending and receiving messages.
- [Pathway Chat](https://docs.bland.ai/api-v1/post/pathway-chat.md): Send a message to a pathway and receive a response.
- [Get Pathway Chat History](https://docs.bland.ai/api-v1/get/pathway-chat.md): Get conversation history for a pathway chat.
- [Get Pathway Versions](https://docs.bland.ai/api-v1/get/pathway_versions.md): Retrieve all versions of a specific pathway.
- [Get Specific Pathway Version](https://docs.bland.ai/api-v1/get/pathway_version.md): Retrieve a specific version of a pathway including its nodes and edges.
- [Promote Pathway Version](https://docs.bland.ai/api-v1/post/pathway-promote.md): Promote a pathway version to staging or production.
- [Create Pathway Version](https://docs.bland.ai/api-v1/post/create_pathway_version.md): Create a new version of a specific pathway.
- [Update Pathway Version](https://docs.bland.ai/api-v1/post/update-pathway-version.md): Update a specific pathway version's name, nodes, and edges.
- [Delete Pathway Version](https://docs.bland.ai/api-v1/delete/pathway_version.md): Archive a specific pathway version.
- [Get All Folders](https://docs.bland.ai/api-v1/get/pathway_folders.md): Retrieve all pathway folders for the authenticated user.
- [Get Pathways in Folder](https://docs.bland.ai/api-v1/get/folder_pathways.md): Retrieve all pathways within a specific folder.
- [Create Folder](https://docs.bland.ai/api-v1/post/create_pathway_folder.md): Create a new pathway folder.
- [Delete Folder](https://docs.bland.ai/api-v1/delete/pathway_folder.md): Delete a specific folder (must be empty).
- [Update Folder](https://docs.bland.ai/api-v1/post/update_pathway_folder.md): Update the name of a specific folder.
- [Move Pathway](https://docs.bland.ai/api-v1/post/move-pathway-folder.md): Move a pathway to a different folder or to the root level.

## API Reference: Knowledge Bases

- [Upload File](https://docs.bland.ai/api-v1/post/knowledge-learn-file.md): Create a new knowledge base by uploading a file.
- [Upload Text](https://docs.bland.ai/api-v1/post/knowledge-learn-text.md): Create a new knowledge base from direct text input.
- [Scrape Websites](https://docs.bland.ai/api-v1/post/knowledge-learn-web.md): Create a new knowledge base by scraping content from web URLs.
- [List Knowledge Bases](https://docs.bland.ai/api-v1/get/knowledge.md): Retrieve a paginated list of knowledge bases for your organization.
- [Get Knowledge Base](https://docs.bland.ai/api-v1/get/knowledge-id.md): Retrieve a specific knowledge base by ID.
- [Update Knowledge Base](https://docs.bland.ai/api-v1/put/knowledge-id.md): Update a knowledge base's name and/or description.
- [Delete Knowledge Base](https://docs.bland.ai/api-v1/delete/knowledge-id.md): Delete a knowledge base.
- [Discover Sitemap URLs](https://docs.bland.ai/api-v1/post/knowledge-crawl.md): Discover URLs from a website's sitemap for web scraping.
- [Chat with Knowledge Base](https://docs.bland.ai/api-v1/post/knowledge-chat.md): Perform a conversational query against knowledge bases with context.

### Vector Knowledge Bases (Deprecated)

- [Create Knowledge Base](https://docs.bland.ai/api-v1/post/vectors.md): Create a new knowledge base.
- [Upload Media](https://docs.bland.ai/api-v1/post/upload-media.md): Upload a media file as a new knowledge base.
- [Upload Text](https://docs.bland.ai/api-v1/post/upload-text.md): Upload a text file as a new knowledge base.
- [Update Knowledge Base](https://docs.bland.ai/api-v1/patch/vectors-id.md): Update a knowledge base.
- [List Knowledge Bases](https://docs.bland.ai/api-v1/get/vectors.md): List all knowledge bases in your account.
- [Get Knowledge Base Details](https://docs.bland.ai/api-v1/get/vectors-id.md): View the details for a specific knowledge base.
- [Delete Knowledge Base](https://docs.bland.ai/api-v1/delete/vectors-id.md): Remove a knowledge base from your account.

## API Reference: Numbers

- [Purchase Phone Number](https://docs.bland.ai/api-v1/post/inbound-purchase.md): Purchase a new phone number ($15/mo).
- [Update Inbound Number](https://docs.bland.ai/api-v1/post/inbound-number-update.md): Update an inbound agent's settings and prompt.
- [Update Inbound Number Label](https://docs.bland.ai/api-v1/post/inbound-update-label.md): Update the label shown for an inbound phone number.
- [List Numbers](https://docs.bland.ai/api-v1/get/inbound.md): Retrieve all inbound phone numbers configured for your account.
- [Number Details](https://docs.bland.ai/api-v1/get/inbound-number.md): Retrieve settings for a specific inbound phone number.
- [Create Inbound Session](https://docs.bland.ai/api-v1/post/inbound-session.md): Create a session token to pass variables to inbound calls via SIP headers.

## API Reference: Blocked Numbers

- [Create Block Rules](https://docs.bland.ai/api-v1/post/blocked-numbers.md): Create rules to prevent specific phone numbers from reaching your inbound numbers.
- [List Block Rules](https://docs.bland.ai/api-v1/get/blocked-numbers.md): Retrieve block rules associated with your inbound numbers.
- [Get Block Rule](https://docs.bland.ai/api-v1/get/blocked-numbers-id.md): Retrieve the details of a specific block rule.
- [Delete Block Rule](https://docs.bland.ai/api-v1/delete/blocked-numbers-id.md): Permanently delete a block rule.
- [Edit Block Rule](https://docs.bland.ai/api-v1/post/blocked-numbers-id-edit.md): Update attributes of an existing block rule.

## API Reference: Widgets

- [Create Widget](https://docs.bland.ai/api-v1/post/widget.md): Create a new web chat/voice widget.
- [List Widgets](https://docs.bland.ai/api-v1/get/widgets.md): Retrieve all widgets associated with your account.
- [Get Widget](https://docs.bland.ai/api-v1/get/widget-id.md): Retrieve a specific widget by ID.
- [Update Widget](https://docs.bland.ai/api-v1/patch/widget-id.md): Update an existing widget.
- [Get Widget Threads](https://docs.bland.ai/api-v1/get/widget-id-threads.md): Retrieve all conversation threads for a specific widget.
- [Send Live Agent Message](https://docs.bland.ai/api-v1/post/widget-thread-webhook.md): Send a message from a live agent to the user, or end the conversation.
- [List Custom Components](https://docs.bland.ai/api-v1/get/widget-custom-components.md): Retrieve custom components for widgets.
- [Create Custom Component](https://docs.bland.ai/api-v1/post/widget-custom-components.md): Create a new custom widget component.
- [Update Custom Component](https://docs.bland.ai/api-v1/patch/widget-custom-components-id.md): Update a specific custom component.
- [Delete Custom Component](https://docs.bland.ai/api-v1/delete/widget-custom-components-id.md): Delete a specific custom component.

## API Reference: Tools

- [Create Tool](https://docs.bland.ai/api-v2/post/tools.md): Create a new v2 tool connecting to built-in integrations or custom APIs, invoked automatically during calls and SMS conversations.
- [Update Tool](https://docs.bland.ai/api-v2/post/tools-tool-id.md): Update an existing v2 tool.
- [List Tools](https://docs.bland.ai/api-v2/get/tools.md): Retrieve a paginated list of your v2 tools.
- [Tool Execution Logs](https://docs.bland.ai/api-v2/get/tools-logs.md): Retrieve per-execution logs for your tools with filtering and pagination.
- [Tool Execution Stats](https://docs.bland.ai/api-v2/get/tools-logs-stats.md): Retrieve aggregated execution statistics for your tools (max 90-day range).
- [Create Custom Tool (Legacy)](https://docs.bland.ai/api-v1/post/tools.md): Create a legacy custom tool that calls external APIs.
- [Update Custom Tool (Legacy)](https://docs.bland.ai/api-v1/post/tools-tool-id.md): Update a legacy custom tool's parameters.
- [Delete Custom Tool (Legacy)](https://docs.bland.ai/api-v1/delete/tools-tool-id.md): Delete a legacy custom tool.
- [List Custom Tools (Legacy)](https://docs.bland.ai/api-v1/get/tools.md): Retrieve legacy custom tools you've created.
- [Custom Tool Details (Legacy)](https://docs.bland.ai/api-v1/get/tools-tool-id.md): Retrieve a specific legacy custom tool.

## API Reference: Contacts

- [List Contacts](https://docs.bland.ai/api-v1/get/contacts.md): List all contacts for your organization with identifiers and memory entities.
- [Find Contact](https://docs.bland.ai/api-v1/get/contacts-find.md): Find a contact by phone number, email, or external ID.
- [Get Contact](https://docs.bland.ai/api-v1/get/contacts-id.md): Retrieve a contact by its unique ID.
- [Resolve Contact](https://docs.bland.ai/api-v1/post/contacts-resolve.md): Find an existing contact or create a new one.
- [Update Contact](https://docs.bland.ai/api-v1/patch/contacts-id.md): Update an existing contact's information.
- [Merge Contacts](https://docs.bland.ai/api-v1/post/contacts-merge.md): Merge two contacts into one, moving all data to the primary contact.

## API Reference: Memory

- [Create Contact Memory](https://docs.bland.ai/api-v1/post/memory-contact.md): Create a memory record for a contact scoped to a persona or agent number.
- [Get Contact Memory](https://docs.bland.ai/api-v1/get/memory-contact-id.md): Retrieve a contact's full memory record including summary, facts, and recent messages.
- [List Recent Messages](https://docs.bland.ai/api-v1/get/memory-contact-id-messages.md): Retrieve recent cross-channel message history for a contact memory.
- [Update Conversation Summary](https://docs.bland.ai/api-v1/patch/memory-contact-id-summary.md): Overwrite the conversation summary for a contact memory.
- [Update Contact Facts](https://docs.bland.ai/api-v1/patch/memory-contact-id-facts.md): Merge new structured facts into a contact's memory record.
- [Get Memory Context](https://docs.bland.ai/api-v1/get/memory-context.md): Retrieve the full memory context a contact scoped to a persona or agent number sees at conversation start.
- [Get Memory Changes](https://docs.bland.ai/api-v1/get/memory-changes.md): Retrieve what memory was captured or updated during a specific call or SMS conversation.
- [Reset Contact Memory](https://docs.bland.ai/api-v1/post/memory-reset.md): Permanently delete all memory for a contact scoped to a specific persona or agent number.
- [Enable or Disable Memory](https://docs.bland.ai/api-v1/post/memory-enable.md): Enable or disable memory for a pathway or persona version.

### Memory Store (Legacy)

- [List All Memories](https://docs.bland.ai/api-v1/get/memory.md): Retrieve all memory stores associated with your account.
- [Get Memory Details](https://docs.bland.ai/api-v1/get/memory-memory-id.md): Retrieve detailed information about a specific memory store and its users.
- [Create Memory](https://docs.bland.ai/api-v1/post/memory-create.md): Create a new memory to organize and track call interactions by phone numbers.
- [Update Memory](https://docs.bland.ai/api-v1/post/memory-memory-id-update.md): Update the name of an existing memory.
- [Delete Memory](https://docs.bland.ai/api-v1/post/memory-memory-id-delete.md): Permanently delete an entire memory and all associated data including users, calls, and metadata.
- [Get User Memory Details](https://docs.bland.ai/api-v1/post/memory-memory-id-user.md): Retrieve detailed memory information for a specific user or phone number in a memory store.
- [Search User Calls in Memory](https://docs.bland.ai/api-v1/post/memory-memory-id-user-search.md): Retrieve call history and data for a specific user or phone number within a memory.
- [Add User to Memory](https://docs.bland.ai/api-v1/post/memory-memory-id-add-user.md): Add a new user or phone number to an existing memory.
- [Update User Memory Data](https://docs.bland.ai/api-v1/post/memory-memory-id-user-update.md): Update the metadata and summary information for a specific user within a memory.
- [Remove User from Memory](https://docs.bland.ai/api-v1/post/memory-memory-id-user-delete.md): Remove a specific user or phone number and all their associated data from a memory.
- [Add Call to Memory](https://docs.bland.ai/api-v1/post/memory-memory-id-add-call.md): Add an existing call to a memory.
- [Remove Call from Memory](https://docs.bland.ai/api-v1/post/memory-memory-id-call-call-id-delete.md): Remove a specific call from a memory.

## API Reference: Node Tests

- [Get Node Test Run](https://docs.bland.ai/api-v1/get/node_test_run.md): Retrieve a node test run.
- [Invoke Node Test Run](https://docs.bland.ai/api-v1/post/node_test_invoke.md): Start a node test run for a given node and pathway with a new prompt and sample conversations.

## API Reference: Agent Testing

- [Create Test Scenario](https://docs.bland.ai/api-v1/post/agent-testing-scenarios.md): Create a new test scenario with assertions for a pathway or persona.
- [List Test Scenarios](https://docs.bland.ai/api-v1/get/agent-testing-scenarios.md): List all test scenarios for your organization.
- [Get Test Scenario](https://docs.bland.ai/api-v1/get/agent-testing-scenarios-id.md): Retrieve a specific test scenario with its assertions.
- [Update Test Scenario](https://docs.bland.ai/api-v1/put/agent-testing-scenarios-id.md): Update an existing test scenario.
- [Delete Test Scenario](https://docs.bland.ai/api-v1/delete/agent-testing-scenarios-id.md): Delete a test scenario and all related data.
- [List Test Templates](https://docs.bland.ai/api-v1/get/agent-testing-templates.md): List out-of-box test scenario templates.
- [Clone Test Template](https://docs.bland.ai/api-v1/post/agent-testing-templates-clone.md): Clone a template to create a new scenario bound to your pathway or persona.
- [Generate Scenario from Call](https://docs.bland.ai/api-v1/post/agent-testing-scenarios-generate.md): Generate a test scenario from a historical call transcript using AI analysis.
- [Run Test Scenario](https://docs.bland.ai/api-v1/post/agent-testing-scenarios-run.md): Execute a single test scenario asynchronously.
- [Batch Run Scenarios](https://docs.bland.ai/api-v1/post/agent-testing-batch-run.md): Execute multiple test scenarios as a batch.
- [List Test Runs](https://docs.bland.ai/api-v1/get/agent-testing-runs.md): List test runs with optional filtering and pagination.
- [Get Test Run](https://docs.bland.ai/api-v1/get/agent-testing-runs-id.md): Retrieve detailed results for a specific test run including assertion results and scores.
- [Get Test Batch](https://docs.bland.ai/api-v1/get/agent-testing-batches-id.md): Retrieve a test batch and all its runs.
- [Analyze Failed Run](https://docs.bland.ai/api-v1/post/agent-testing-runs-analyze.md): Run AI-powered analysis on a failed test run to get root cause and fix suggestions.
- [Get Test Analytics](https://docs.bland.ai/api-v1/get/agent-testing-analytics.md): Get basic testing analytics for a pathway over a time window.
- [Get Enhanced Analytics](https://docs.bland.ai/api-v1/get/agent-testing-analytics-enhanced.md): Get enhanced analytics including node failure heatmap, weakest link, trend analysis, and Sankey flow data.
- [Create Simulation Set](https://docs.bland.ai/api-v1/post/agent-testing-simulation-sets.md): Create a simulation set that runs each scenario multiple times to detect flaky behavior.
- [Get Simulation Set](https://docs.bland.ai/api-v1/get/agent-testing-simulation-sets-id.md): Retrieve a simulation set with pass rates, flakiness detection, and score distributions.
- [Start Tornado Session](https://docs.bland.ai/api-v1/post/agent-testing-tornado-start.md): Start an iterative fix loop that runs tests, analyzes failures, applies fixes, and retests until all scenarios pass.
- [Get Active Tornado Session](https://docs.bland.ai/api-v1/get/agent-testing-tornado-active.md): Get the currently active tornado session for a pathway.
- [Get Tornado Status](https://docs.bland.ai/api-v1/get/agent-testing-tornado-status.md): Get detailed progress for a tornado session including iteration data and fix plans.
- [Cancel Tornado Session](https://docs.bland.ai/api-v1/post/agent-testing-tornado-cancel.md): Cancel a running tornado session.

## API Reference: Evals

Grade real calls at scale with configurable LLM judges. Evals define agents (single-question judges), workbench setups (bundles of judges scored together), and runs that score a batch of calls against them.

### Eval Agents

- [List Eval Agents](https://docs.bland.ai/api-v1/get/evals-agents.md): List the eval agents in your organization.
- [Get Eval Agent](https://docs.bland.ai/api-v1/get/evals-agents-id.md): Fetch one eval agent and its current draft version.
- [Create Eval Agent](https://docs.bland.ai/api-v1/post/evals-agents.md): Create a new eval agent, optionally seeded from a template.
- [Update Eval Agent](https://docs.bland.ai/api-v1/patch/evals-agents-id.md): Update an eval agent's metadata or repoint its active version.
- [Publish Eval Agent](https://docs.bland.ai/api-v1/post/evals-agents-id-publish.md): Publish the agent's current draft as a new active version.
- [Delete Eval Agent](https://docs.bland.ai/api-v1/delete/evals-agents-id.md): Soft-delete an eval agent.

### Eval Agent Versions

- [List Eval Agent Versions](https://docs.bland.ai/api-v1/get/evals-agents-id-versions.md): List all versions of an eval agent.
- [Get Eval Agent Version](https://docs.bland.ai/api-v1/get/evals-agents-id-versions-id.md): Fetch one version of an eval agent.
- [Create Eval Agent Version](https://docs.bland.ai/api-v1/post/evals-agents-id-versions.md): Fork a new editable draft version of an eval agent.
- [Update Eval Agent Version](https://docs.bland.ai/api-v1/patch/evals-agents-id-versions-id.md): Edit a draft version's prompt, levels, targets, or weight.

### Workbench Setups

- [List Workbench Setups](https://docs.bland.ai/api-v1/get/evals-workbench-setups.md): List the workbench setups in your organization.
- [Get Workbench Setup](https://docs.bland.ai/api-v1/get/evals-workbench-setups-id.md): Fetch one workbench setup and its current draft version.
- [Create Workbench Setup](https://docs.bland.ai/api-v1/post/evals-workbench-setups.md): Create a new workbench setup with an empty draft version.
- [Update Workbench Setup](https://docs.bland.ai/api-v1/patch/evals-workbench-setups-id.md): Update a workbench setup's metadata or repoint its active version.
- [Publish Workbench Setup](https://docs.bland.ai/api-v1/post/evals-workbench-setups-id-publish.md): Publish the setup's current draft as a new active version.
- [Delete Workbench Setup](https://docs.bland.ai/api-v1/delete/evals-workbench-setups-id.md): Soft-delete a workbench setup.

### Workbench Setup Versions

- [List Workbench Setup Versions](https://docs.bland.ai/api-v1/get/evals-workbench-setups-id-versions.md): List all versions of a workbench setup.
- [Get Workbench Setup Version](https://docs.bland.ai/api-v1/get/evals-workbench-setups-id-versions-id.md): Fetch one version of a workbench setup.
- [Create Workbench Setup Version](https://docs.bland.ai/api-v1/post/evals-workbench-setups-id-versions.md): Fork a new editable draft version of a workbench setup.
- [Update Workbench Setup Version](https://docs.bland.ai/api-v1/patch/evals-workbench-setups-id-versions-id.md): Edit a draft version's attached agents, threshold, run mode, or default calls.

### Experiments

- [List Eval Runs](https://docs.bland.ai/api-v1/get/evals-runs.md): List eval runs in your organization, with optional filters.
- [Get Eval Run](https://docs.bland.ai/api-v1/get/evals-runs-id.md): Fetch one eval run and its current status and summary.
- [Create Eval Run](https://docs.bland.ai/api-v1/post/evals-runs.md): Start a new eval run over a batch of calls.
- [Estimate Eval Run](https://docs.bland.ai/api-v1/post/evals-runs-estimates.md): Preview the size and cost of a run before starting it.
- [Cancel Eval Run](https://docs.bland.ai/api-v1/post/evals-runs-id-cancel.md): Cancel a pending or running eval run.
- [List Agent Results](https://docs.bland.ai/api-v1/get/evals-runs-id-agent-results.md): List every individual judge verdict in an eval run.
- [List Agent Snapshots](https://docs.bland.ai/api-v1/get/evals-runs-id-agent-snapshots.md): List the frozen agent configurations a run scored against.
- [List Call Results](https://docs.bland.ai/api-v1/get/evals-runs-id-call-results.md): List the per-call results for an eval run.

### Templates

- [List Eval Agent Templates](https://docs.bland.ai/api-v1/get/evals-agent-templates.md): List the read-only library of shipped eval agent templates.
- [Get Eval Agent Template](https://docs.bland.ai/api-v1/get/evals-agent-templates-key.md): Fetch a single shipped eval agent template by its key.
- [List User Templates](https://docs.bland.ai/api-v1/get/evals-user-templates.md): List your organization's saved eval agent templates.
- [Get User Template](https://docs.bland.ai/api-v1/get/evals-user-templates-id.md): Fetch one of your organization's saved eval agent templates.
- [Create User Template](https://docs.bland.ai/api-v1/post/evals-user-templates.md): Save a new eval agent template, from scratch or by snapshotting an existing eval agent.
- [Update User Template](https://docs.bland.ai/api-v1/patch/evals-user-templates-id.md): Update a saved eval agent template. Source pointers cannot be changed.
- [Delete User Template](https://docs.bland.ai/api-v1/delete/evals-user-templates-id.md): Soft-delete a saved eval agent template.

### Status

- [Get Evals Status](https://docs.bland.ai/api-v1/get/evals-status.md): Check whether the Evals feature is enabled for your organization.

## API Reference: Live Translation

- [Create Translation Session](https://docs.bland.ai/api-v1/post/translation-sessions.md): Create a real-time translation session and receive a WebSocket URL for streaming audio.
- [Get Translation Session](https://docs.bland.ai/api-v1/get/translation-sessions-id.md): Retrieve the status, duration, and billing details of a translation session.
- [End Translation Session](https://docs.bland.ai/api-v1/delete/translation-sessions-id.md): Terminate a translation session from the server side.

## API Reference: Guard Rails

- [List Guard Rails](https://docs.bland.ai/api-v1/get/guard-rails.md): Retrieve all guard rails in your organization.
- [Get Guard Rail](https://docs.bland.ai/api-v1/get/guard-rails-id.md): Retrieve a specific guard rail by ID.
- [Create Guard Rail](https://docs.bland.ai/api-v1/post/guard-rails.md): Create a new guard rail for compliance monitoring.
- [Update Guard Rail](https://docs.bland.ai/api-v1/patch/guard-rails-id.md): Update an existing guard rail configuration.
- [Delete Guard Rail](https://docs.bland.ai/api-v1/delete/guard-rails-id.md): Delete a guard rail.

## API Reference: Web Agents

- [Create Web Agent](https://docs.bland.ai/api-v1/post/agents.md): Configure all settings for a new web agent.
- [Update Web Agent](https://docs.bland.ai/api-v1/post/agents-id.md): Update a web agent's settings, prompt, and details.
- [Authorize Web Agent Call](https://docs.bland.ai/api-v1/post/agents-id-authorize.md): Create a single-use session token for a client to talk with your web agent.
- [Delete Web Agent](https://docs.bland.ai/api-v1/post/agents-id-delete.md): Delete a web agent.
- [List Web Agents](https://docs.bland.ai/api-v1/get/agents.md): Retrieve each web agent you've created along with their settings.

## API Reference: Custom Twilio Accounts

- [Create Encrypted Key](https://docs.bland.ai/api-v1/post/accounts.md): Integrate your own Twilio account with Bland.
- [Delete Encrypted Key](https://docs.bland.ai/api-v1/post/accounts-delete.md): Disable an encrypted key for a Twilio account integration.
- [Upload Inbound Phone Numbers](https://docs.bland.ai/api-v1/post/inbound-insert.md): Add inbound numbers to Bland from your own Twilio account.
- [Delete Inbound Phone Number](https://docs.bland.ai/api-v1/post/inbound-number-delete.md): Remove an inbound number uploaded through your own Twilio account.

## API Reference: Batches

- [Create Batch](https://docs.bland.ai/api-v2/post/batches.md): Create a new batch of calls using direct input.
- [List Batches](https://docs.bland.ai/api-v2/get/batches.md): Retrieve a list of all batches created by your organization.
- [Get Batch](https://docs.bland.ai/api-v2/get/batches-id.md): Retrieve metadata for a specific batch.
- [Get Batch Logs](https://docs.bland.ai/api-v2/get/batches-id-logs.md): Retrieve logs for a specific batch.
- [Stop Batch](https://docs.bland.ai/api-v2/post/batches-id-stop.md): Stop a batch that is currently running or scheduled.

## API Reference: Prompts

- [List Prompts](https://docs.bland.ai/api-v1/get/prompts.md): Retrieve all your saved prompts.
- [Prompt Details](https://docs.bland.ai/api-v1/get/prompts-id.md): Retrieve data for a specific prompt.
- [Create Prompt](https://docs.bland.ai/api-v1/post/prompts.md): Create and store a prompt for future use.

## API Reference: Account

- [Account Details](https://docs.bland.ai/api-v1/get/me.md): Returns call data and details for your account.

## API Reference: Organizations

- [Create Organization](https://docs.bland.ai/api-v1/post/orgs.md): Create a new organization.
- [Delete Organization](https://docs.bland.ai/api-v1/delete/orgs.md): Delete an organization.
- [Get Organization](https://docs.bland.ai/api-v1/get/orgs.md): Retrieve details of an organization.
- [Get Organization Members](https://docs.bland.ai/api-v1/get/org_members.md): Retrieve the list of members in an organization.
- [Get Current Service Version](https://docs.bland.ai/api-v1/get/org_current_version.md): Retrieve the current version of a service for an organization.
- [List Service Versions](https://docs.bland.ai/api-v1/get/org_list_versions.md): Retrieve available versions of a service within an organization.
- [Update Service Version](https://docs.bland.ai/api-v1/patch/org_version.md): Update the current version of a service for an organization.
- [Update Organization Members](https://docs.bland.ai/api-v1/patch/org_members.md): Add or remove members from an organization.
- [Update Member Permissions](https://docs.bland.ai/api-v1/patch/org_member_permissions.md): Modify permissions of an existing member within an organization.
- [Update Organization Properties](https://docs.bland.ai/api-v1/patch/org_properties.md): Modify specific properties of an organization.
- [Get User Memberships](https://docs.bland.ai/api-v1/get/org_list_self_memberships.md): Retrieve organizations the authenticated user is a member of.
- [Leave Organization](https://docs.bland.ai/api-v1/delete/org_leave_self_memberships_id.md): Remove the authenticated user from an organization.
- [Get Billing Information](https://docs.bland.ai/api-v1/get/org_billing_information.md): Retrieve current billing details for an organization.
- [Get Billing Refill Information](https://docs.bland.ai/api-v1/get/org_billing_refill_information.md): Retrieve the recharge amount for an organization's billing.
- [List Audit Logs](https://docs.bland.ai/api-v1/get/audit-logs.md): Retrieve a paginated, filterable list of audit events for SIEM integration and compliance workflows.

## API Reference: Messaging

- [List SMS Numbers](https://docs.bland.ai/api-v1/get/sms-numbers.md): Retrieve all phone numbers configured for SMS along with their configuration.
- [Update SMS Configuration](https://docs.bland.ai/api-v1/post/sms-update.md): Update the SMS configuration for a phone number.
- [Send SMS Message](https://docs.bland.ai/api-v1/post/sms-send.md): Send an SMS message from an agent to a user, creating or resuming a conversation.
- [Send SMS Batch](https://docs.bland.ai/api-v1/post/sms-batch.md): Send SMS messages to a large list of recipients from a pre-uploaded CSV file.
- [Create SMS Conversation](https://docs.bland.ai/api-v1/post/sms-create.md): Create an SMS conversation with specific pathway state without triggering immediate sending.
- [List Conversations](https://docs.bland.ai/api-v1/get/sms-conversations.md): Retrieve a paginated list of SMS conversations with filtering and sorting.
- [Get Conversation](https://docs.bland.ai/api-v1/get/sms-conversations-id.md): Retrieve a single SMS conversation and its messages by ID.
- [Update SMS Conversation](https://docs.bland.ai/api-v1/patch/sms-conversations-id.md): Update properties of an existing SMS conversation.
- [Delete Messages from Conversation](https://docs.bland.ai/api-v1/delete/sms-conversations-message.md): Delete specific messages from SMS conversations.
- [Delete Conversation](https://docs.bland.ai/api-v1/delete/sms-conversations.md): Permanently delete a conversation and all its messages.
- [Get Post Conversation Webhook](https://docs.bland.ai/api-v1/get/sms-conversations-webhook.md): Retrieve the webhook delivery log for an SMS conversation.
- [SMS Conversation Analysis](https://docs.bland.ai/api-v1/post/sms-analyze.md): Answer questions and extract information from an SMS conversation.

## API Reference: SIP Trunks

- [Get SIP Config](https://docs.bland.ai/api-v1/get/sip-config.md): Retrieve the current SIP configuration for a phone number.
- [List SIP Numbers](https://docs.bland.ai/api-v1/get/sip-numbers.md): List all phone numbers with SIP configurations for your organization.
- [Attach SIP Configuration](https://docs.bland.ai/api-v1/post/sip-attach.md): Attach SIP configuration to phone numbers for inbound and/or outbound routing.
- [Update SIP Direction](https://docs.bland.ai/api-v1/post/sip-update.md): Update an existing SIP routing direction for a phone number.
- [Detach SIP Configuration](https://docs.bland.ai/api-v1/post/sip-detach.md): Remove SIP configuration from a phone number.
- [Discover SIP Endpoint](https://docs.bland.ai/api-v1/post/sip-discover.md): Auto-discover optimal SIP connection settings by probing your endpoint.
- [Get Discovery Status](https://docs.bland.ai/api-v1/get/sip-discover-status.md): Poll the status and results of a SIP endpoint discovery session.
- [Parse SIP Destination](https://docs.bland.ai/api-v1/post/sip-parse-destination.md): Parse and validate a raw SIP destination string into its host, port, user, and transport.
- [Generate SIP Password](https://docs.bland.ai/api-v1/get/sip-generate-password.md): Generate a strong, PBX-safe SIP password for register-based authentication.
- [Send SIP Test Call](https://docs.bland.ai/api-v1/post/sip-test-call.md): Place a live test call to your SIP endpoint to verify connectivity.
- [Get Test Call Status](https://docs.bland.ai/api-v1/get/sip-test-call-status.md): Poll the status and trace of a SIP test call.
- [Get Firewall IPs](https://docs.bland.ai/api-v1/get/sip-firewall-ips.md): Get Bland's static IP addresses for your region to configure your firewall.
- [Get Outbound Setup](https://docs.bland.ai/api-v1/get/sip-outbound-setup.md): Get Bland's SIP server details and PBX configuration for outbound call routing.
- [Get Trunk Health](https://docs.bland.ai/api-v1/get/sip-status.md): Get the health status of a SIP trunk by probing the endpoint.
- [Get SIP Call Logs](https://docs.bland.ai/api-v1/get/sip-calls.md): Retrieve SIP call logs for a phone number with cursor-based pagination.
- [Update Advanced Config](https://docs.bland.ai/api-v1/patch/sip-config.md): Update advanced SIP configuration including failover, codecs, and alerts.
- [Check Number Portability](https://docs.bland.ai/api-v1/get/sip-port-check.md): Check whether phone numbers are eligible for porting to Bland.
- [Upload Port Document](https://docs.bland.ai/api-v1/post/sip-port-document.md): Upload a Letter of Authorization or proof of ownership document for number porting.
- [Initiate Port Request](https://docs.bland.ai/api-v1/post/sip-port-initiate.md): Submit a number porting request to transfer phone numbers to Bland.
- [List Port Requests](https://docs.bland.ai/api-v1/get/sip-port-requests.md): List all number porting requests for your organization.
- [Cancel Port Request](https://docs.bland.ai/api-v1/delete/sip-port-cancel.md): Cancel an in-progress number porting request.

## API Reference: Custom Dialing Pools

- [Get Custom Dialing Pool](https://docs.bland.ai/api-v1/get/custom-dialing-pool.md): Retrieve a specific custom dialing pool by its ID.
- [List Custom Dialing Pools](https://docs.bland.ai/api-v1/get/custom-dialing-pools.md): Retrieve all custom dialing pools for your organization.
- [Create Custom Dialing Pool](https://docs.bland.ai/api-v1/post/custom-dialing-pools.md): Create a new custom dialing pool with phone numbers for optimized call routing.
- [Update Custom Dialing Pool](https://docs.bland.ai/api-v1/post/custom-dialing-pool-update.md): Update an existing custom dialing pool.

## API Reference: Personas

- [List Personas](https://docs.bland.ai/api-v1/get/personas.md): Retrieve all personas in your organization.
- [Get Persona](https://docs.bland.ai/api-v1/get/personas-id.md): Retrieve a specific persona.
- [Create Persona](https://docs.bland.ai/api-v1/post/personas.md): Create a new persona.
- [Update Persona](https://docs.bland.ai/api-v1/patch/personas-id.md): Update an existing persona configuration.
- [Delete Persona](https://docs.bland.ai/api-v1/delete/personas-id.md): Delete a persona.
- [Attach Phone Numbers to Persona](https://docs.bland.ai/api-v1/post/personas-id-inbound-attach.md): Attach one or more inbound phone numbers to a persona.
- [Detach Phone Numbers from Persona](https://docs.bland.ai/api-v1/post/personas-id-inbound-detach.md): Detach one or more inbound phone numbers from a persona.
- [Update Persona Number Settings](https://docs.bland.ai/api-v1/patch/personas-id-inbound-phone-settings.md): Update persona-specific settings for a phone number attached to a persona.
- [List Persona Versions](https://docs.bland.ai/api-v1/get/personas-id-versions.md): Retrieve all versions of a specific persona.
- [Promote Persona Version](https://docs.bland.ai/api-v1/post/personas-id-versions-promote.md): Promote a persona's draft version to production.
- [Get Specific Persona Version](https://docs.bland.ai/api-v1/get/personas-id-versions-version-id.md): Retrieve a specific persona version.

## API Reference: Citation Schemas

- [List Citation Schemas](https://docs.bland.ai/api-v1/get/citation-schemas-list.md): Retrieve all citation schemas for your organization.
- [Get Citation Schema](https://docs.bland.ai/api-v1/get/citation-schemas-id.md): Retrieve a specific citation schema by ID.
- [Create Citation Schema](https://docs.bland.ai/api-v1/post/citation-schemas.md): Create a new schema for extracting structured data from call transcripts.
- [Update Citation Schema](https://docs.bland.ai/api-v1/patch/citation-schemas.md): Update an existing citation schema's name, description, or configuration.
- [Backfill Citation Schema](https://docs.bland.ai/api-v1/post/citation-schemas-backfill.md): Retroactively apply citation schemas to extract data from existing call transcripts.

## API Reference: Alarms

- [List Alarms](https://docs.bland.ai/api-v1/get/alarms.md): List alarm configurations for your organization.
- [Create Alarm](https://docs.bland.ai/api-v1/post/alarms.md): Create an alarm configuration for your organization.
- [List Alarm Events](https://docs.bland.ai/api-v1/get/alarms-history.md): Get recent alarm events across all alarms in your organization.
- [Get Alarm](https://docs.bland.ai/api-v1/get/alarms-id.md): Get a single alarm configuration by ID.
- [Update Alarm](https://docs.bland.ai/api-v1/patch/alarms-id.md): Update an alarm configuration.
- [Delete Alarm](https://docs.bland.ai/api-v1/delete/alarms-id.md): Delete an alarm configuration.
- [Toggle Alarm](https://docs.bland.ai/api-v1/post/alarms-id-toggle.md): Enable or disable an alarm.
- [Trigger Alarm Evaluation](https://docs.bland.ai/api-v1/post/alarms-id-trigger.md): Manually trigger alarm evaluation with current data.
- [Test Alarm Notifications](https://docs.bland.ai/api-v1/post/alarms-id-notify.md): Send a test alarm or recovery notification.

## API Reference: Triage

Issues capture problems found on calls, bundle the evidence (calls, SMS conversations, files), and hand the work to Norm, Bland's triage agent, to investigate and fix.

- [Create Issue](https://docs.bland.ai/api-v1/post/triage-issues.md): Create a triage issue.
- [List Issues](https://docs.bland.ai/api-v1/get/triage-issues.md): List triage issues with filters and keyset pagination.
- [Get Issue](https://docs.bland.ai/api-v1/get/triage-issues-id.md): Get a triage issue by ID.
- [Update Issue](https://docs.bland.ai/api-v1/patch/triage-issues-id.md): Update a triage issue. All fields optional.
- [Delete Issue](https://docs.bland.ai/api-v1/delete/triage-issues-id.md): Permanently delete a triage issue.
- [Attach Resource](https://docs.bland.ai/api-v1/post/triage-issues-id-resources.md): Attach a call, SMS conversation, or file to an issue.
- [List Resources](https://docs.bland.ai/api-v1/get/triage-issues-id-resources.md): List resources attached to an issue.
- [Remove Resource](https://docs.bland.ai/api-v1/delete/triage-issues-id-resources-resource-link-id.md): Detach a resource from an issue.
- [Attach Call](https://docs.bland.ai/api-v1/put/triage-issues-id-calls-call-id.md): Attach a call to an issue (call_id shorthand).
- [Detach Call](https://docs.bland.ai/api-v1/delete/triage-issues-id-calls-call-id.md): Detach a call from an issue (call_id shorthand).
- [Get Affected Context](https://docs.bland.ai/api-v1/get/triage-issues-id-affected.md): Roll up calls, pathways, and personas affected by an issue.
- [Add Flag](https://docs.bland.ai/api-v1/post/triage-issues-id-flags.md): Flag a moment on an attached call.
- [List Flags](https://docs.bland.ai/api-v1/get/triage-issues-id-flags.md): List flags on an issue.
- [Remove Flag](https://docs.bland.ai/api-v1/delete/triage-issues-id-flags-flag-id.md): Remove a flag from an issue.
- [List Flag Types](https://docs.bland.ai/api-v1/get/triage-flag-types.md): List reusable flag types in your org with usage counts.
- [List Activity](https://docs.bland.ai/api-v1/get/triage-issues-id-activity.md): Unified activity feed for an issue, including Norm session events.
- [Add Comment](https://docs.bland.ai/api-v1/post/triage-issues-id-comments.md): Comment on an issue. Mention @norm to dispatch a Norm investigation.
- [Mark Issue Viewed](https://docs.bland.ai/api-v1/put/triage-issues-id-view.md): Mark an issue as viewed by the calling user.
- [List Categories](https://docs.bland.ai/api-v1/get/triage-categories.md): List issue categories.
- [Create Category](https://docs.bland.ai/api-v1/post/triage-categories.md): Create a custom issue category.
- [Link Related Issue](https://docs.bland.ai/api-v1/post/triage-issues-id-relations.md): Link an issue to another issue.
- [List Relations](https://docs.bland.ai/api-v1/get/triage-issues-id-relations.md): List relations on an issue.
- [Remove Relation](https://docs.bland.ai/api-v1/delete/triage-issues-id-relations-relation-id.md): Remove a relation between two issues.
- [List Agents](https://docs.bland.ai/api-v1/get/triage-agents.md): List triage agent profiles.
- [Create Agent Session](https://docs.bland.ai/api-v1/post/triage-issues-id-agent-sessions.md): Create a Norm agent session on an issue.
- [Prompt Norm](https://docs.bland.ai/api-v1/post/triage-issues-id-agent-sessions-session-id-prompts.md): Send a prompt to Norm. Returns 202 with a run ID.

## Instructions for AI Agents: Best Practices for Integrating Bland

As an AI agent integrating with Bland, prefer Conversational Pathways for any multi-turn or branching call flow. For simple one-off calls, pass a `task` string directly to `POST /v1/calls`. For structured flows, always use a `pathway_id`.

Use the v2 Tools API (`POST /v2/tools`) for all new tool integrations, never the legacy Custom Tools (`POST /v1/tools`). Tools can call any HTTP endpoint and inject the response back into the live conversation. Store credentials using Secrets and reference them by name in tool configurations rather than hardcoding values.

For inbound calls, purchase a number and attach it to a pathway or persona via the inbound API. Personas are the recommended abstraction when managing multiple phone numbers with a shared agent identity. Configure the persona once and attach any number of phone numbers to it.

For testing, use the Testbed to iterate on node prompts with real call data and Standards to lock in regression-tested behavior. Run Scenarios for automated end-to-end pathway validation before deploying changes. Enable Guard Rails in production to continuously monitor every AI response for critical failures.

Use post-call webhooks to process transcripts, extract structured data, and sync results to external systems after a call ends. Always validate incoming Bland webhooks using the HMAC signature before processing the payload.

When voice is important, use BTTS v2 to create a voice clone. Reference the cloned voice by ID in the `voice` parameter of your call request.

For batch outbound campaigns, use `POST /v2/batches` with a recipient list. Monitor batch progress with `GET /v2/batches/{id}` and stop a running batch with `POST /v2/batches/{id}/stop`.

Never hardcode phone numbers into test scripts. Use the Bland dashboard or CLI to manage numbers. Always check the API Reference at https://docs.bland.ai/api-v1/post/calls for the full parameter list when sending calls.