Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

Manage your entire Bland account from the terminal: make calls, build and test pathways, configure phone numbers, and more. Install via NPM: bland-cli 
# Install globally
npm install -g bland-cli

# Or run without installing
npx bland-cli
Requirements: Node.js 18+

​
Getting started

bland auth login --key YOUR_API_KEY
Or set the environment variable: 
export BLAND_API_KEY=your_key_here

# Check your account
bland auth whoami

# Make an outbound call
bland call send +15551234567 --task "Ask about demo" --voice nat --wait

# List recent calls
bland call list

​
What you can do

Make outbound calls with customizable voices, tasks, and pathways. View and analyze call history directly from the terminal.
bland call send +15551234567 --task "Schedule a follow-up" --voice maya
bland call list
bland call get <call_id>
bland call stop <call_id>
bland call events <call_id>
bland call recording <call_id>
bland call analyze <call_id>
Create and manage conversational pathways as YAML files. Sync local YAML with the Bland API, run interactive tests, and automate test cases.
bland pathway init ./my-pathway --name "Customer Support"
bland pathway push ./my-pathway
bland pathway pull <id> ./my-pathway
bland pathway diff ./my-pathway
bland pathway validate ./my-pathway
bland pathway watch ./my-pathway
bland pathway list
bland pathway get <id>
bland pathway create
bland pathway chat <id> --verbose
bland pathway test <id>
bland pathway simulate <id>
bland pathway promote <id>
bland pathway versions <id>
bland pathway generate --description "..."
Purchase, configure, and release phone numbers from your terminal.
bland number list
bland number buy --area-code 415
bland number release <number>
bland number update <number>
bland number configure <number>
Browse available voices and synthesize audio samples.
bland voice list
bland voice speak "Hello there" --voice nat -o hello.mp3
Create and manage personas for your agents, including versioning and knowledge gap tracking.
bland persona list
bland persona get <id>
bland persona create
bland persona update <id>
bland persona delete <id>
bland persona promote <id>
bland persona reset-draft <id>
bland persona gaps <id>
Create and manage custom tools that your agents can call during conversations.
bland tool list
bland tool get <id>
bland tool create
bland tool update <id>
bland tool delete <id>
bland tool test <id> --input '{"key": "value"}'
Create and manage knowledge bases, including populating them via web scraping.
bland knowledge list
bland knowledge create <name>
bland knowledge scrape <name> --urls https://example.com
bland knowledge status <id>
bland knowledge delete <id>
Automate large-scale outbound call campaigns.
bland batch create --file contacts.csv --pathway <id>
bland batch list
bland batch get <id>
bland batch stop <id>
Send and manage SMS conversations through the CLI.
bland sms send +15551234567 --message "Hello!"
bland sms conversations
bland sms get <id>
Manage web agents.
bland agent list
bland agent get <id>
bland agent create
bland agent update <id>
bland agent delete <id>
Configure guard rails for your agents.
bland guard list
bland guard create
bland guard delete <id>
Set up monitoring alarms and manage secrets.
bland alarm list
bland alarm create
bland alarm delete <id>

bland secret list
bland secret set
bland secret delete <name>
Manage releases and embeddable widgets.
bland release list
bland release create
bland release promote <id>

bland widget list
bland widget create
bland widget delete <id>
Generate TTS audio, analyze audio files, and manage SIP endpoints.
bland audio generate <text> --voice nat -o output.mp3
bland audio analyze <file>
bland sip discover <host>
Run and manage automated pathway test cases.
bland eval run <pathway_id>
bland eval list
bland eval get <id>
bland eval add <pathway_id>

​
Local Webhook Development

Forward Bland webhooks to your local dev server without ngrok: 
# Terminal 1: your app
node server.js

# Terminal 2: bland webhook forwarder
bland listen --forward-to http://localhost:3000/webhook

​
MCP Server

The CLI includes an MCP (Model Context Protocol) server, which lets AI coding tools like Claude Code and Cursor interact with your Bland account through natural language. 
bland mcp

# Or with SSE transport
bland mcp --transport sse --port 3100

​
Claude Code Setup

Add to your Claude Code config: 
{
  "mcpServers": {
    "bland": {
      "command": "npx",
      "args": ["bland-cli", "mcp"]
    }
  }
}
Once running, AI tools can make calls, manage pathways, check your balance, and more without leaving your development environment.

​
JSON Output

Every list and get command supports --json for piping to jq or scripts: 
bland pathway list --json | jq '.[].id'
bland call get <id> --json | jq '.transcripts'
bland number list --json | jq 'length'

​
Environment Variables

VariablePurpose
BLAND_API_KEYAPI key (overrides stored profile)
BLAND_BASE_URLAPI base URL (default: https://api.bland.ai)

​
Profiles

The CLI supports multiple profiles for managing different API keys or organizations. 
bland auth login --key sk-...    # Add a profile
bland auth switch                # Switch between profiles
bland auth profiles              # List all profiles
bland auth logout                # Clear credentials
Profiles are stored at ~/.config/bland-cli/config.json. You can also override the API key per-command with BLAND_API_KEY.
Docs for agents: llms.txt