# 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.

## Which page to read first

- If you are a personal AI agent (Grok Bot, Meta Muse, OpenClaw, Instinct, Poke, or similar) asked to integrate with Bland or get a phone number: read [Personal AI Agents](https://docs.bland.ai/integrations/mcp/personal-agents.md) first, follow it, then stop. Do not start from the MCP clients or Cursor setup.
- If you are a coding agent (Claude Code, Claude Desktop, Cursor, Codex) building Bland Agents: read [Norm plugin](https://docs.bland.ai/integrations/mcp/norm.md).
- If your owner has no Bland account: read [Headless agent onboarding](https://docs.bland.ai/platform/agent-headless-onboarding.md). The owner relays one SMS code and you receive an API key, no browser step. With an agent wallet that can approve a payment (a shared payment token from the Link CLI, or the CLI answering the payment challenge; not a Link virtual card), pay for the Agent Phone Plan in the same call and receive a phone number too.
- If your owner already has a Bland account and you have no key: read [Agent onboarding API](https://docs.bland.ai/platform/connect-your-agent.md). You show the owner a link and a code, and they sign in and approve in a browser.
- For anything else, start at [Bland MCP Server](https://docs.bland.ai/integrations/mcp/overview.md) or the sections below.

## 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.

## Getting Started

- [Build your first agent](https://docs.bland.ai/build-your-first-agent.md): From a new account to an agent you have called and heard answer, in four steps.

## Agents: Build

- [Agent builder](https://docs.bland.ai/agents/agent-builder.md): Build an agent end to end: prompts, variables, scenarios, tools, knowledge, settings, and publishing.
- [Tools](https://docs.bland.ai/agents/tools.md): Build the tools an agent calls during a conversation, and store the credentials they need.
- [Knowledge](https://docs.bland.ai/agents/knowledge.md): Add the sources your agent answers from, attach them to an agent, and test what it retrieves.
- [Conversations](https://docs.bland.ai/agents/conversations.md): Find, read, and export every conversation your agents have had, across phone, messaging, and web chat.
- [Testbed](https://docs.bland.ai/agents/testbed.md): Take one turn from a real conversation, change what the agent was told, and run it again to see whether the answer changes.
- [Dispatch](https://docs.bland.ai/agents/dispatch.md): Put a published agent into service: attach a phone number, set how it behaves on each channel, and run batches.
- [Triggers](https://docs.bland.ai/agents/triggers.md): Start conversations automatically from an event: pick what fires it, filter on the payload, and choose what happens.
- [SIP](https://docs.bland.ai/agents/sip.md): Connect your own carrier to Bland: create trunks, attach numbers and DIDs, port numbers in, and route calls in both directions.
- [Environments](https://docs.bland.ai/agents/environments.md): Ship an agent safely: what development, staging and production hold, how to publish and promote, and why a call needs a production version.
- [Dispositions](https://docs.bland.ai/agents/dispositions.md): Decide what you want to know about every conversation, and have the answers delivered to your webhook after each call.
- [Evaluations](https://docs.bland.ai/agents/evaluations.md): Score an agent before it ships: write a judge, build a test case, read a run, and make a passing run a condition of promotion.
- [Migrate to agents](https://docs.bland.ai/platform/migrate-to-agents.md): What changes, where every feature went, the three ways to migrate, and what to do once your agent exists.

## 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.

## AI Agents & MCP

- [Bland MCP Server](https://docs.bland.ai/integrations/mcp/overview.md): Connect coding agents and compatible personal AI agents to your Bland account over MCP.
- [Sign in with Bland (OAuth)](https://docs.bland.ai/integrations/mcp/oauth.md): Connect an MCP client to your Bland account by signing in instead of pasting an API key: the flow you see, what the client can do, and what client developers need.
- [Norm plugin](https://docs.bland.ai/integrations/mcp/norm.md): Install norm@bland to build, migrate, validate, and test Bland Agents from your coding agent.
- [MCP Clients](https://docs.bland.ai/integrations/mcp/clients.md): Connect the Bland MCP server to Claude Code, Cursor, Codex, VS Code, Claude Desktop, Windsurf, Gemini CLI, or any coding tool.
- [Connect Claude Code to the Bland MCP server](https://docs.bland.ai/integrations/mcp/clients/claude-code.md): Connect Claude Code to your Bland account with one command, or install the Norm plugin for Bland Agents skills and /norm:* commands.
- [Connect Cursor to the Bland MCP server](https://docs.bland.ai/integrations/mcp/clients/cursor.md): Connect Cursor to your Bland account with a one-click install or an mcp.json entry, or use the Norm plugin for Bland Agents work.
- [Connect OpenAI Codex to the Bland MCP server](https://docs.bland.ai/integrations/mcp/clients/codex.md): Connect OpenAI Codex to your Bland account with a config.toml entry, or use the Norm plugin for Bland Agents work.
- [Connect VS Code to the Bland MCP server](https://docs.bland.ai/integrations/mcp/clients/vs-code.md): Connect VS Code and GitHub Copilot to your Bland account with a one-click install or an mcp.json entry.
- [Connect Claude Desktop to the Bland MCP server](https://docs.bland.ai/integrations/mcp/clients/claude-desktop.md): Connect the Claude Desktop app to your Bland account with the Norm plugin, Sign in with Bland, request-header authentication, or a stdio bridge.
- [Connect Windsurf to the Bland MCP server](https://docs.bland.ai/integrations/mcp/clients/windsurf.md): Connect Windsurf's legacy Cascade agent to your Bland account, or find the MCP configuration for Devin Local.
- [Connect Gemini CLI to the Bland MCP server](https://docs.bland.ai/integrations/mcp/clients/gemini-cli.md): Connect Gemini CLI to your Bland account with a settings.json entry.
- [Connect any MCP client to Bland](https://docs.bland.ai/integrations/mcp/clients/other.md): Connect any MCP client or your own agent loop to the Bland MCP server over streamable HTTP, a stdio bridge, or raw JSON-RPC.
- [Personal AI Agents](https://docs.bland.ai/integrations/mcp/personal-agents.md): Connect personal AI agents to Bland with MCP or REST, and check each assistant's integration requirements.
- [Grok Bot](https://docs.bland.ai/integrations/mcp/grok-bot.md): Check Grok Bot's connection requirements and configure Bland when custom MCP servers are available.
- [Meta Muse](https://docs.bland.ai/integrations/mcp/meta-muse.md): Integrate Meta Muse with Bland: give your Muse agent its own phone number and let it call and text on your behalf.
- [OpenClaw](https://docs.bland.ai/integrations/mcp/openclaw.md): Integrate OpenClaw with Bland: give your OpenClaw agent its own phone number and let it call and text on your behalf.
- [Instinct](https://docs.bland.ai/integrations/mcp/instinct.md): Check the requirements for connecting Instinct to Bland and find documented alternatives.
- [Poke](https://docs.bland.ai/integrations/mcp/poke.md): Integrate Poke with Bland: give your Poke assistant its own phone number and let it call and text on your behalf.
- [Agent onboarding API](https://docs.bland.ai/platform/connect-your-agent.md): The device-authorization flow an AI agent follows to sign itself up for Bland: it shows its owner a link and a code, the owner finishes signup in a browser, and the agent gets an API key, plus a phone number if the owner starts the Agent Phone Plan.
- [Headless agent onboarding](https://docs.bland.ai/platform/agent-headless-onboarding.md): Two unauthenticated calls that let an agent with an agent wallet sign its owner up, pay for the Agent Phone Plan with a shared payment token or through a Machine Payments Protocol 402 challenge, and receive an API key and phone number in one conversation.
- [Agent quickstart](https://docs.bland.ai/platform/agent-quickstart.md): Place a call, learn how it ended, and read the transcript: the call lifecycle an autonomous agent needs, in three requests.
- [Call recipes for agents](https://docs.bland.ai/platform/agent-call-recipes.md): Named patterns for the three things agents hit first: voicemail handling, getting proper nouns transcribed correctly, and escalating to a human during open hours.
- [Making calls sound human](https://docs.bland.ai/platform/sounding-human.md): The dispatch settings and prompt-writing rules that decide whether a call sounds like a person or like a robot reading copy.
- [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.
- [Setup guide for Bland (HubSpot)](https://docs.bland.ai/tutorials/integrations/hubspot.md): Install the Bland app from the HubSpot App Marketplace, connect your HubSpot account, and configure how your AI agents read and update your CRM.
- [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.
- [Knowledge base editing](https://docs.bland.ai/tutorials/knowledge-base-editing.md): Edit knowledge base sources in the Bland dashboard, with side-by-side editors showing the original PDF, DOCX, or JSON next to the text your agent uses.
- [Pathway Call Events](https://docs.bland.ai/tutorials/pathway-call-events.md): The event timeline recorded for every pathway call: every event type, field, and payload shape.

## 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.
- [Agent Phone Plan](https://docs.bland.ai/platform/agent-phone-plan.md): A plan at $14.99 for the first month (50% off), then $29.99/month, for autonomous agents: unlimited calling and texting to the US and Canada on one dedicated number.

## 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: Agent Onboarding

- [Start Agent Onboarding](https://docs.bland.ai/api-v1/post/agent-onboarding-start.md): Start the device-authorization flow a bot uses to get its own Bland API key, plus a phone number if its owner starts the Agent Phone Plan. Accepts prefill values that pre-fill the owner's sign-up form.
- [Poll Agent Onboarding](https://docs.bland.ai/api-v1/post/agent-onboarding-poll.md): Poll for the result of a device-authorization flow.
- [Approve Agent Onboarding](https://docs.bland.ai/api-v1/post/agent-onboarding-approve.md): Claim a device-authorization code after the owner signs up in the browser and chooses the Agent Phone Plan or free credits.

## API Reference: Agent Phone Plan

- [Cancel Agent Phone Plan](https://docs.bland.ai/api-v1/post/agent-phone-plan-cancel.md): Cancel your organization's Agent Phone Plan immediately, with an optional offboarding survey.
- [Submit Cancellation Feedback](https://docs.bland.ai/api-v1/post/agent-phone-plan-cancel-feedback.md): Answer the optional Agent Phone Plan offboarding survey after you've canceled.

## 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 item by uploading a file.
- [Upload Text](https://docs.bland.ai/api-v1/post/knowledge-learn-text.md): Create a new knowledge base item from direct text input.
- [Scrape Websites](https://docs.bland.ai/api-v1/post/knowledge-learn-web.md): Create a new knowledge base item by scraping content from web URLs.
- [List Knowledge Base Items](https://docs.bland.ai/api-v1/get/knowledge.md): Retrieve a paginated list of knowledge base items for your organization.
- [Get Knowledge Base Item](https://docs.bland.ai/api-v1/get/knowledge-id.md): Retrieve a specific knowledge base item by ID.
- [Update Knowledge Base Item](https://docs.bland.ai/api-v1/put/knowledge-id.md): Update a knowledge base item's name and/or description.
- [Delete Knowledge Base Item](https://docs.bland.ai/api-v1/delete/knowledge-id.md): Delete a knowledge base item.
- [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 Item](https://docs.bland.ai/api-v1/post/knowledge-chat.md): Perform a conversational query against knowledge base items with context.

### Vector Knowledge Bases (Deprecated)

- [Create Knowledge Base Item](https://docs.bland.ai/api-v1/post/vectors.md): Create a new knowledge base item.
- [Upload Media](https://docs.bland.ai/api-v1/post/upload-media.md): Upload a media file as a new knowledge base item.
- [Upload Text](https://docs.bland.ai/api-v1/post/upload-text.md): Upload a text file as a new knowledge base item.
- [Update Knowledge Base Item](https://docs.bland.ai/api-v1/patch/vectors-id.md): Update a knowledge base item.
- [List Knowledge Base Items](https://docs.bland.ai/api-v1/get/vectors.md): List all knowledge base items in your account.
- [Get Knowledge Base Item Details](https://docs.bland.ai/api-v1/get/vectors-id.md): View the details for a specific knowledge base item.
- [Delete Knowledge Base Item](https://docs.bland.ai/api-v1/delete/vectors-id.md): Remove a knowledge base item 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.
- [Get Voice Pool](https://docs.bland.ai/api-v1/get/inbound-number-voice-pool.md): List the voices in an inbound number's voice pool.
- [Set Voice Pool](https://docs.bland.ai/api-v1/post/inbound-number-voice-pool.md): Replace the voice pool on an inbound 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: API Keys

- [Create API Key](https://docs.bland.ai/api-v1/post/keys-create.md): Create a full-access or restricted API key for your organization.
- [List API Keys](https://docs.bland.ai/api-v1/post/keys-list.md): List your organization's API keys and the permissions each one holds.
- [Rename API Key](https://docs.bland.ai/api-v1/patch/keys-rename.md): Change the name of an API key.
- [Delete API Key](https://docs.bland.ai/api-v1/delete/keys-delete.md): Revoke an API key.

## 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.

## API Reference: Agents (V2)

The V2 Agents API is the programmatic surface for the new Bland dashboard. An agent is an org-scoped record whose configuration lives in immutable versions; three environments (dev, staging, production) each pin a version. Publish and promote move those pins. Branches are dev workspaces merged back by rebase. Checks gate promotions, experiments A/B a variant against an environment's pin, and dispositions (enabled per organization) classify call outcomes. All routes live under `https://api.bland.ai/v2/agents` and return `{ "data": ..., "errors": null }` on success.

- [Overview](https://docs.bland.ai/api-v2/overview.md): What the Agents API covers, how an agent is structured, and where to start.
- [Create Agent](https://docs.bland.ai/api-v2/post/agents.md): Create an agent with empty dev, staging, and production environments.
- [Send Call with an Agent](https://docs.bland.ai/api-v1/post/calls-agent.md): Place an outbound call with one of your agents.
- [List Agents](https://docs.bland.ai/api-v2/get/agents.md): List the agents in your organization, most recently updated first.
- [Get Agent](https://docs.bland.ai/api-v2/get/agents-id.md): Retrieve an agent and its environment pointers.
- [Update Agent](https://docs.bland.ai/api-v2/patch/agents-id.md): Change an agent's display name.
- [Delete Agent](https://docs.bland.ai/api-v2/delete/agents-id.md): Soft-delete an agent. Versions and history are kept.
- [Create Agent Version](https://docs.bland.ai/api-v2/post/agents-id-versions.md): Save an agent configuration snapshot as a new version.
- [List Agent Versions](https://docs.bland.ai/api-v2/get/agents-id-versions.md): List an agent's saved versions, newest first.
- [Get Latest Agent Version](https://docs.bland.ai/api-v2/get/agents-id-versions-latest.md): Retrieve the newest saved version with its full snapshot.
- [Get Agent Version](https://docs.bland.ai/api-v2/get/agents-id-versions-semver.md): Retrieve a published version by its semantic version.
- [Get Scenario History](https://docs.bland.ai/api-v2/get/agents-id-scenarios-node-id-history.md): List how one scenario changed across saved versions.
- [Get Agent Number Binding](https://docs.bland.ai/api-v2/get/agents-id-inbound.md): Check which phone numbers are attached to an agent and whether each one answers on the production or staging environment.
- [Attach Numbers to Agent](https://docs.bland.ai/api-v2/post/agents-id-inbound-attach.md): Route inbound calls on your phone numbers to an agent.
- [Detach Numbers from Agent](https://docs.bland.ai/api-v2/post/agents-id-inbound-detach.md): Stop routing inbound calls on phone numbers to an agent.
- [List Agent Environments](https://docs.bland.ai/api-v2/get/agents-id-environments.md): List an agent's environments with their pinned versions.
- [List Agent Deployments](https://docs.bland.ai/api-v2/get/agents-id-deployments.md): List an environment's deployment history, newest first.
- [Publish Agent to Staging](https://docs.bland.ai/api-v2/post/agents-id-publish.md): Publish a version to the staging environment.
- [Promote Agent to Production](https://docs.bland.ai/api-v2/post/agents-id-promote.md): Pin production to the version currently in staging.
- [Roll Back Agent](https://docs.bland.ai/api-v2/post/agents-id-rollback.md): Repoint production at a previously deployed version.
- [List Agent Branches](https://docs.bland.ai/api-v2/get/agents-id-branches.md): List an agent's open branches.
- [Create Agent Branch](https://docs.bland.ai/api-v2/post/agents-id-branches.md): Create a branch off the agent's dev head.
- [Delete Agent Branch](https://docs.bland.ai/api-v2/delete/agents-id-branches-branch-id.md): Abandon an open branch without merging it.
- [Preview Agent Branch Rebase](https://docs.bland.ai/api-v2/post/agents-id-branches-branch-id-rebase-preview.md): Preview a branch rebase onto the current dev head.
- [Rebase Agent Branch](https://docs.bland.ai/api-v2/post/agents-id-branches-branch-id-rebase.md): Rebase a branch onto the dev head with resolutions.
- [Merge Agent Branch](https://docs.bland.ai/api-v2/post/agents-id-branches-branch-id-merge.md): Fast-forward a branch into the agent's dev timeline.
- [List Agent Variables](https://docs.bland.ai/api-v2/get/agents-id-environments-env-variables.md): List an environment's variables for an agent.
- [Set Agent Variable](https://docs.bland.ai/api-v2/put/agents-id-environments-env-variables-key.md): Set an environment variable on an agent.
- [Delete Agent Variable](https://docs.bland.ai/api-v2/delete/agents-id-environments-env-variables-key.md): Delete an environment variable from an agent.
- [Get Checks](https://docs.bland.ai/api-v2/get/agents-id-environments-env-checks.md): Retrieve an environment's check config.
- [Set Checks](https://docs.bland.ai/api-v2/put/agents-id-environments-env-checks.md): Replace an environment's check config.
- [Delete Checks](https://docs.bland.ai/api-v2/delete/agents-id-environments-env-checks.md): Remove an environment's check config.
- [Start Check Run](https://docs.bland.ai/api-v2/post/agents-id-environments-env-check-runs.md): Start a check run against a candidate version.
- [List Check Runs](https://docs.bland.ai/api-v2/get/agents-id-check-runs.md): List an agent's check runs for one environment.
- [Get Check Run](https://docs.bland.ai/api-v2/get/agents-id-check-runs-run-id.md): Retrieve a check run and its verdicts.
- [Cancel Check Run](https://docs.bland.ai/api-v2/post/agents-id-check-runs-run-id-cancel.md): Cancel a pending or running check run.
- [Create Experiment](https://docs.bland.ai/api-v2/post/agents-id-experiments.md): Start an A/B experiment on a variant version.
- [List Experiments](https://docs.bland.ai/api-v2/get/agents-id-experiments.md): List an agent's experiments, newest first.
- [Get Experiment](https://docs.bland.ai/api-v2/get/agents-id-experiments-experiment-id.md): Retrieve one experiment and its live progress.
- [Update Experiment](https://docs.bland.ai/api-v2/patch/agents-id-experiments-experiment-id.md): Adjust an active experiment's split or conditions.
- [Stop Experiment](https://docs.bland.ai/api-v2/post/agents-id-experiments-experiment-id-stop.md): End an active experiment and return traffic to baseline.
- [List Library Scenarios](https://docs.bland.ai/api-v2/get/agents-library-scenarios.md): List reusable scenarios from your other agents.
- [List Archived Nodes](https://docs.bland.ai/api-v2/get/agents-library-archived-nodes.md): List nodes archived from your organization's agents.
- [Delete Archived Node](https://docs.bland.ai/api-v2/delete/agents-library-archived-nodes-archived-node-id.md): Permanently remove an entry from the node archive.
- [Archive Agent Node](https://docs.bland.ai/api-v2/post/agents-id-archived-nodes.md): Copy a node from an agent into the organization archive.
- [Migrate Pathway](https://docs.bland.ai/api-v2/post/agents-migrate.md): Plan and build an agent from a legacy pathway graph.
- [Stream Pathway Migration](https://docs.bland.ai/api-v2/post/agents-migrate-stream.md): Run a pathway migration with live progress events.
- [Migrate Persona](https://docs.bland.ai/api-v2/post/agents-migrate-persona.md): Build an agent from a persona and its attached pathways.
- [Migrate Pathways](https://docs.bland.ai/api-v2/post/agents-migrate-pathways.md): Convert stored or inline pathways into agent scenarios.
- [Start Pathway Translation](https://docs.bland.ai/api-v2/post/agents-migrate-translations.md): Start an async job translating pathways into scenarios.
- [Get Pathway Translation Run](https://docs.bland.ai/api-v2/get/agents-migrate-translations-run-id.md): Poll the status and result of a translation job.
- [Cancel Pathway Translation Run](https://docs.bland.ai/api-v2/post/agents-migrate-translations-run-id-cancellations.md): Cancel a pending or running translation job.
- [List Dispositions](https://docs.bland.ai/api-v2/get/agents-id-dispositions.md): List the dispositions defined on an agent.
- [Create Disposition](https://docs.bland.ai/api-v2/post/agents-id-dispositions.md): Create a disposition with an initial draft definition.
- [Get Disposition](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id.md): Retrieve a disposition's summary and lifecycle state.
- [Get Disposition Draft](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-draft.md): Retrieve a disposition's live draft definition.
- [Update Disposition Draft](https://docs.bland.ai/api-v2/patch/agents-id-dispositions-disposition-id-draft.md): Replace a disposition's draft definition.
- [List Disposition Versions](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-versions.md): List a disposition's published versions, newest first.
- [Get Disposition Version](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-versions-version-id.md): Retrieve one published disposition version.
- [Estimate Disposition Cost](https://docs.bland.ai/api-v2/post/agents-id-dispositions-disposition-id-estimates.md): Estimate a disposition's per-call cost before publishing.
- [Publish Disposition](https://docs.bland.ai/api-v2/post/agents-id-dispositions-disposition-id-publish.md): Publish a disposition draft as an immutable version.
- [Disable Disposition](https://docs.bland.ai/api-v2/post/agents-id-dispositions-disposition-id-disable.md): Stop a disposition from running on new calls.
- [List Disposition Test Runs](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-runs.md): List test runs for a disposition.
- [Create Disposition Test Run](https://docs.bland.ai/api-v2/post/agents-id-dispositions-disposition-id-runs.md): Run a disposition against completed production calls.
- [Get Disposition Test Run](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id.md): Retrieve a test run with live progress counts.
- [Get Test Run Rows](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id-rows.md): Page through a test run's per-call results.
- [Export Test Run CSV](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id-export-csv.md): Download a test run's results as CSV.
- [Align Disposition Test Run](https://docs.bland.ai/api-v2/post/agents-id-dispositions-disposition-id-runs-run-id-align.md): Propose definition edits from a test run's corrections.
- [Correct Test Run Value](https://docs.bland.ai/api-v2/put/agents-id-dispositions-disposition-id-runs-run-id-cases-call-id-annotations-value-id.md): Record a corrected value for one call in a test run.
- [List Test Run Correction Revisions](https://docs.bland.ai/api-v2/get/agents-id-dispositions-disposition-id-runs-run-id-cases-call-id-annotations-value-id.md): List correction revisions for one call and value.
- [List Disposition Extractors](https://docs.bland.ai/api-v2/get/agents-id-dispositions-extractors.md): List the extractors available to an agent's dispositions.
- [Create Disposition Extractor](https://docs.bland.ai/api-v2/post/agents-id-dispositions-extractors.md): Create an extractor with its first editable version.
- [Get Disposition Extractor](https://docs.bland.ai/api-v2/get/agents-id-dispositions-extractors-extractor-id.md): Retrieve an extractor with its draft and published versions.
- [Get Disposition Extractor Version](https://docs.bland.ai/api-v2/get/agents-id-dispositions-extractors-extractor-id-versions-version-id.md): Retrieve one version of an extractor.
- [Update Disposition Extractor Draft](https://docs.bland.ai/api-v2/patch/agents-id-dispositions-extractors-extractor-id-draft.md): Edit an extractor's editable draft version.
- [Publish Disposition Extractor](https://docs.bland.ai/api-v2/post/agents-id-dispositions-extractors-extractor-id-publish.md): Publish an extractor draft as an immutable version.
- [Get Judge Catalog](https://docs.bland.ai/api-v2/get/agents-id-dispositions-judge-catalog.md): List the judges a disposition can pin for this agent.
- [Get Judge Version](https://docs.bland.ai/api-v2/get/agents-id-dispositions-judges-judge-id-versions-version-id.md): Retrieve one version of a judge's rubric.
- [Get Variable Catalog](https://docs.bland.ai/api-v2/get/agents-id-dispositions-variable-catalog.md): List the agent variables a disposition can re-extract.
- [Get Model Profile Catalog](https://docs.bland.ai/api-v2/get/agents-id-dispositions-model-profile-catalog.md): List the model profiles available to extractors.
- [Get Extractor Catalog](https://docs.bland.ai/api-v2/get/agents-id-dispositions-extractor-catalog.md): List the published extractors a disposition can pin.
- [Get Agent Identity](https://docs.bland.ai/api-v2/get/agents-id-identity.md): Read the agent's branded contact card and its delivery settings.
- [Update Agent Identity](https://docs.bland.ai/api-v2/put/agents-id-identity.md): Change the agent's contact card fields and delivery settings.
- [Upload Agent Logo](https://docs.bland.ai/api-v2/post/agents-id-identity-logo.md): Upload the logo shown on the agent's contact card.
- [Download Agent Contact Card](https://docs.bland.ai/api-v2/get/agents-id-identity-contact-card.md): Download the agent's contact card as a vCard file.
- [Send Test Contact Card](https://docs.bland.ai/api-v2/post/agents-id-identity-contact-card-test.md): Send the agent's contact card to one number to check how it arrives.
- [Get Agent Memory Schema](https://docs.bland.ai/api-v2/get/agents-id-memory-schema.md): Read what the agent remembers about each contact between calls.
- [Infer Agent Memory Schema](https://docs.bland.ai/api-v2/post/agents-id-memory-schema-infer.md): Generate a suggested memory schema by reading the agent.
- [Delete Disposition](https://docs.bland.ai/api-v2/delete/agents-id-dispositions-disposition-id.md): Retire a disposition so it stops classifying new calls.
- [Remove Check Eval](https://docs.bland.ai/api-v2/delete/agents-id-environments-env-checks-evals-eval-agent-id.md): Drop one eval from an environment's promotion checks.

## 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.