# Dasha BlackBox Documentation > Build, deploy, and monitor voice AI agents with Dasha BlackBox. Complete documentation for creating intelligent conversational AI agents with advanced voice capabilities. ## Docs - [Add Realistic Background Sounds to Conversations](https://blackbox.dasha.ai/docs/advanced-features/ambient-noise.md): Add realistic background sounds to your Dasha BlackBox voice agent. Make conversations more natural with office, cafe, or custom ambient noise that eliminates uncanny silence. - [Add Active Listening Cues to Conversations](https://blackbox.dasha.ai/docs/advanced-features/backchannel.md): Enable your Dasha BlackBox voice agent to produce active listening cues like 'mm-hmm', 'I see', and 'right' while callers speak. Create more engaging, natural conversations with intelligent backchannel responses. - [Route Calls to Human Operators](https://blackbox.dasha.ai/docs/advanced-features/call-transfers.md): Transfer Dasha BlackBox voice agent calls to human operators or other systems. Warm transfers brief operators with context first. Cold transfers provide direct routing for speed. HTTP transfers use webhook-based dynamic routing for intelligent assignment. - [Set Up Fast Direct Routing](https://blackbox.dasha.ai/docs/advanced-features/call-transfers/cold-transfer.md): Configure cold transfers for fast, direct routing without operator briefing. Your agent transfers the call immediately and disconnects—caller goes straight to the destination with no three-way handoff. Simple to set up, ideal for high-volume basic escalations and IVR routing where speed matters more… - [Route Calls Dynamically with Webhooks](https://blackbox.dasha.ai/docs/advanced-features/call-transfers/http-transfer.md): Configure HTTP transfers for dynamic, webhook-based call routing. Your agent calls your endpoint with conversation context, your system checks CRM data, availability, and skill levels, then returns the routing decision. Route premium customers to senior agents, balance workload across teams, and app… - [Brief Operators Before Connecting Callers](https://blackbox.dasha.ai/docs/advanced-features/call-transfers/warm-transfer.md): Configure warm transfers where the AI agent briefs the operator before connecting the caller, providing context and ensuring smooth handoffs for personalized customer service. - [Add Natural Verbal Pauses During Processing](https://blackbox.dasha.ai/docs/advanced-features/fillers.md): Add natural verbal pauses like 'um', 'let me check that', and 'one moment' to your Dasha BlackBox voice agent during processing delays. Research shows these fillers reduce perceived wait time by up to 40%, making conversations feel more human. - [Handle Voicemail and Automated Phone Systems](https://blackbox.dasha.ai/docs/advanced-features/ivr-detection.md): Detect when Dasha BlackBox voice agent calls reach automated systems or voicemail. Leave professional messages, navigate menus with DTMF tones, or disconnect gracefully. - [Connect Your Agent to Knowledge Bases](https://blackbox.dasha.ai/docs/advanced-features/knowledge-base.md): Connect your Dasha BlackBox voice agent to knowledge bases for accurate, real-time information retrieval. Your agent searches documentation, FAQs, and product manuals instead of relying on memory—this approach (Retrieval-Augmented Generation/RAG) reduces hallucinations. Update your docs and your age… - [Enable Mid-Conversation Language Changes](https://blackbox.dasha.ai/docs/advanced-features/language-switching.md): Enable your Dasha BlackBox voice agent to switch languages mid-conversation when customers request it in the current language. One agent handles multiple languages (English, Spanish, French, etc.). Important: The agent can't detect requests in other languages—customers must ask in the current conver… - [Set Automatic Time Limits for Calls](https://blackbox.dasha.ai/docs/advanced-features/max-call-duration.md): Set automatic time limits for Dasha BlackBox voice agent calls to control costs and prevent stuck calls from running indefinitely. When a call reaches the limit, your agent gracefully ends the conversation. Configure different limits for normal and transferred calls. - [Filter Background Noise from Calls](https://blackbox.dasha.ai/docs/advanced-features/noise-suppression.md): Remove background noise from call audio using Krisp-powered noise suppression. Improve speech recognition accuracy and call quality in noisy environments. - [Enhance Your Voice Agent](https://blackbox.dasha.ai/docs/advanced-features/overview.md): Enhance Dasha BlackBox voice agents with natural conversation features, intelligent call handling, post-call analysis, and powerful integrations. - [Extract Structured Data from Conversations](https://blackbox.dasha.ai/docs/advanced-features/post-call-analysis.md): Automatically analyze and label Dasha BlackBox voice agent conversations using custom categories you define (sentiment, outcomes, topics, follow-up required). After each call, AI determines label values from transcripts—no manual review needed. Structured data flows directly to CRM, analytics dashbo… - [Play Audio Before Conversations Start](https://blackbox.dasha.ai/docs/advanced-features/pre-conversation-media.md): Play a recorded message or audio file immediately when calls connect, before your AI agent speaks. Use for compliance disclosures, greetings, or branded intros. - [Handle Caller Silence with Reminders and Timeouts](https://blackbox.dasha.ai/docs/advanced-features/silence-management.md): Automatically handle caller silence with configurable reminders and timeouts. When callers go silent, your agent prompts ('Are you still there?') and gracefully ends calls after no response. Prevents calls from hanging indefinitely when callers walk away, put phones down, or lose connection. - [Configure Your Agent to Speak First on Calls](https://blackbox.dasha.ai/docs/advanced-features/talk-first.md): Configure your Dasha BlackBox voice agent to speak first when calls connect instead of waiting for callers. Essential for outbound calls where callers don't know who's calling or why. Control opening greetings ('Hi, this is Alex from [Company]...'), timing, and interruptibility to set context and el… - [Search activity log](https://blackbox.dasha.ai/docs/api-reference/activitylogs/search-activity-log.md): Searches activity log events with filtering by type, severity, caller, date range, and free-text search on message and metadata. Returns paginated results with aggregated counts for types, severities, and callers. - [Clone agent](https://blackbox.dasha.ai/docs/api-reference/agents/clone-agent.md): Creates a copy of an existing agent with a new name. The clone inherits the source agent's complete configuration (voice, TTS, LLM, features, webhooks, tools) but is always created in a disabled state and without inbound SIP config to avoid phone number routing conflicts. **What is copi… - [Create agent](https://blackbox.dasha.ai/docs/api-reference/agents/create-agent.md): Creates a new AI voice agent with the specified configuration. The system automatically generates a unique agent ID and assigns infrastructure resources. The response includes the created agent with all assigned infrastructure details and generated identifiers. - [Delete agent](https://blackbox.dasha.ai/docs/api-reference/agents/delete-agent.md): Permanently deletes an AI voice agent from your organization. This operation removes the agent configuration and infrastructure assignments but preserves historical call records. - [Get agent](https://blackbox.dasha.ai/docs/api-reference/agents/get-agent.md): Retrieves detailed configuration for a specific AI voice agent using its unique identifier (UUID). The response includes all agent settings: voice configuration, TTS settings, enabled features (call transfer, recording, ambient noise), SIP configuration, webhook URLs, and infrastructure assignments.… - [Get agents linked to knowledge base](https://blackbox.dasha.ai/docs/api-reference/agents/get-agents-linked-to-knowledge-base.md): Retrieves a list of all agents in your organization that are connected to knowledge bases. This endpoint helps you understand which agents have knowledge base integrations enabled. **Query Options:** - Without parameters: Returns all agents with any knowledge base links - With knowledge… - [List agents](https://blackbox.dasha.ai/docs/api-reference/agents/list-agents.md): Retrieves a paginated list of all AI voice agents within your organization. Each agent in the response includes complete configuration details including voice settings, TTS configuration, features, and infrastructure assignments. **Pagination Parameters:** - Default page size: 20 agents… - [Update agent](https://blackbox.dasha.ai/docs/api-reference/agents/update-agent.md): Updates an existing AI voice agent with a new configuration. This is a full replacement operation where all fields in the request body replace the existing configuration. - [Search call results](https://blackbox.dasha.ai/docs/api-reference/callresults/search-call-results.md): Searches historical call results with advanced filtering, full-text search, nested JSON queries, and aggregations. Supports complex queries including date ranges, status filters, agent filtering, and custom field searches within call additional data. - [Cancel call](https://blackbox.dasha.ai/docs/api-reference/calls/cancel-call.md): Cancels a scheduled call and removes it from the queue. Triggers a webhook notification with call deadline status. This operation cannot cancel calls that are already in progress. - [Create bulk calls](https://blackbox.dasha.ai/docs/api-reference/calls/create-bulk-calls.md): Schedules multiple outbound voice calls with an AI agent in a single request. Each call receives a unique ID and calculated schedule time. This endpoint is optimized for batch operations and campaign management. - [Create call](https://blackbox.dasha.ai/docs/api-reference/calls/create-call.md): Schedules a new outbound voice call with an AI agent. The system assigns a unique call ID and calculates the schedule time based on the provided deadline and timezone. - [Get call](https://blackbox.dasha.ai/docs/api-reference/calls/get-call.md): Retrieves detailed information for a specific call including status, timestamps, endpoint information, and additional data associated with the call. - [Get call queue](https://blackbox.dasha.ai/docs/api-reference/calls/get-call-queue.md): Retrieves the current call queue for your organization with filtering options. Shows scheduled and pending calls that have not yet been completed. Unlike the general call list endpoint, this focuses on active queue items. - [Get call recording](https://blackbox.dasha.ai/docs/api-reference/calls/get-call-recording.md): Streams call recording audio as MP3. Supports both inline streaming for browser playback and file downloads. This endpoint is publicly accessible without authentication. - [Get call statistics](https://blackbox.dasha.ai/docs/api-reference/calls/get-call-statistics.md): Retrieves aggregated call statistics grouped by status. Combines data from both the active queue and historical records to provide complete metrics. - [Get SIP traces](https://blackbox.dasha.ai/docs/api-reference/calls/get-sip-traces.md): Retrieves SIP protocol traces for a specific call, identified by its blackbox call ID. The system resolves the internal server job ID from the call record and fetches SIP signaling data including INVITE, ACK, BYE messages and their raw content, useful for debugging telephony connectivity issues. - [Delete a document](https://blackbox.dasha.ai/docs/api-reference/document/delete-a-document.md) - [Download document content](https://blackbox.dasha.ai/docs/api-reference/document/download-document-content.md) - [Get document chunk information](https://blackbox.dasha.ai/docs/api-reference/document/get-document-chunk-information.md) - [Get document chunks](https://blackbox.dasha.ai/docs/api-reference/document/get-document-chunks.md) - [Get document details with status](https://blackbox.dasha.ai/docs/api-reference/document/get-document-details-with-status.md) - [List documents in a knowledge base](https://blackbox.dasha.ai/docs/api-reference/document/list-documents-in-a-knowledge-base.md) - [Update a document content in KB](https://blackbox.dasha.ai/docs/api-reference/document/update-a-document-content-in-kb.md) - [Upload a document to a knowledge base](https://blackbox.dasha.ai/docs/api-reference/document/upload-a-document-to-a-knowledge-base.md) - [Create a new knowledge base](https://blackbox.dasha.ai/docs/api-reference/knowledgebase/create-a-new-knowledge-base.md) - [Delete a knowledge base and all its content](https://blackbox.dasha.ai/docs/api-reference/knowledgebase/delete-a-knowledge-base-and-all-its-content.md) - [Get all knowledge](https://blackbox.dasha.ai/docs/api-reference/knowledgebase/get-all-knowledge.md) - [Get knowledge base details with statistics](https://blackbox.dasha.ai/docs/api-reference/knowledgebase/get-knowledge-base-details-with-statistics.md) - [Update knowledge base settings](https://blackbox.dasha.ai/docs/api-reference/knowledgebase/update-knowledge-base-settings.md) - [Verify MCP connection](https://blackbox.dasha.ai/docs/api-reference/mcp/verify-mcp-connection.md): Verifies a Model Context Protocol (MCP) connection and discovers available tools. Use this endpoint to test MCP server connectivity before configuring an agent. - [Delete media file](https://blackbox.dasha.ai/docs/api-reference/media/delete-media-file.md): Permanently deletes a media file and automatically removes all references from agents that use this file. The deletion is performed in two stages: first removing agent references, then deleting the file itself. - [Download media file](https://blackbox.dasha.ai/docs/api-reference/media/download-media-file.md): Downloads the media file content as a stream with appropriate Content-Disposition header for file download. - [Get agents using media](https://blackbox.dasha.ai/docs/api-reference/media/get-agents-using-media.md): Returns a list of agents that use the specified media file in their configuration. Each agent entry includes the usage context (warmTransfer, coldTransfer, or ambientNoise) indicating where the media is used. - [Get media file](https://blackbox.dasha.ai/docs/api-reference/media/get-media-file.md): Retrieves metadata for a specific media file including file name, description, upload timestamp, file size, and content type. - [List media files](https://blackbox.dasha.ai/docs/api-reference/media/list-media-files.md): Retrieves all media files for your organization with pagination support. Returns metadata including file names, descriptions, upload dates, and file sizes. - [Update media file](https://blackbox.dasha.ai/docs/api-reference/media/update-media-file.md): Updates the description of an existing media file. This is a partial update (PATCH) that only modifies the description field. Set description to null or empty string to clear it. - [Upload media file](https://blackbox.dasha.ai/docs/api-reference/media/upload-media-file.md): Uploads a new audio file for use with AI agents. Only audio content types (audio/*) are accepted. The uploaded file can be used for hold music, background sounds, or other audio features. - [Get agent template](https://blackbox.dasha.ai/docs/api-reference/misc/get-agent-template.md): Retrieves a template agent configuration with language-specific default values for creating a new agent. Useful for initializing agent forms with appropriate defaults based on language. - [Get capabilities of available models](https://blackbox.dasha.ai/docs/api-reference/misc/get-capabilities-of-available-models.md) - [Get concurrency limits](https://blackbox.dasha.ai/docs/api-reference/misc/get-concurrency-limits.md): Retrieves the concurrent call limit for your organization and the current number of active calls. Use this endpoint to monitor capacity and check if new calls can be initiated. - [Get current organization](https://blackbox.dasha.ai/docs/api-reference/misc/get-current-organization.md): Retrieves the organization ID associated with the current API key. Useful for verifying authentication and organization context. - [Get platform capabilities](https://blackbox.dasha.ai/docs/api-reference/misc/get-platform-capabilities.md): Retrieves platform capabilities for the current deployment instance. Returns the list of available LLM models and IVR voice recognition availability. Each model includes a provider field and a deprecated flag. This endpoint is publicly accessible and does not require authentication. IVR voice recogn… - [Get server configuration](https://blackbox.dasha.ai/docs/api-reference/misc/get-server-configuration.md): Retrieves server configuration information including authentication server URL and SIP server settings. This public endpoint does not require authentication and provides essential connectivity information for client initialization. - [List predefined background sounds](https://blackbox.dasha.ai/docs/api-reference/misc/list-predefined-background-sounds.md): Retrieves the list of predefined background sounds that can be configured for agents to play during calls. Background sounds help create a more natural call environment by adding ambient audio. - [List predefined built-in tools](https://blackbox.dasha.ai/docs/api-reference/misc/list-predefined-built-in-tools.md): Retrieves the list of predefined built-in tools that can be configured for agents. Built-in tools provide standard functionality that agents can use during conversations. - [List predefined builtin media](https://blackbox.dasha.ai/docs/api-reference/misc/list-predefined-builtin-media.md): Retrieves the list of predefined builtin media files that can be used for agent features like pre-conversation media playback. These are pre-uploaded to the platform. - [Add pronunciation rules](https://blackbox.dasha.ai/docs/api-reference/pronunciationdictionaries/add-pronunciation-rules.md): Adds new pronunciation rules to an existing dictionary. After adding rules, automatically updates all agents using this dictionary with the new configuration. - [Create pronunciation dictionary](https://blackbox.dasha.ai/docs/api-reference/pronunciationdictionaries/create-pronunciation-dictionary.md): Creates a new pronunciation dictionary with pronunciation rules for specific words. Supports alias rules (word substitutions) and phoneme rules (phonetic pronunciations). Provider-specific rule restrictions may apply. - [Delete pronunciation dictionary](https://blackbox.dasha.ai/docs/api-reference/pronunciationdictionaries/delete-pronunciation-dictionary.md): Permanently deletes a pronunciation dictionary and automatically removes all references from agents that use this dictionary. - [Get agents using pronunciation dictionary](https://blackbox.dasha.ai/docs/api-reference/pronunciationdictionaries/get-agents-using-pronunciation-dictionary.md): Returns a list of agents that use the specified pronunciation dictionary. Use this endpoint to check which agents will be affected before modifying or deleting a dictionary. - [Get pronunciation dictionary](https://blackbox.dasha.ai/docs/api-reference/pronunciationdictionaries/get-pronunciation-dictionary.md): Retrieves a specific pronunciation dictionary by its identifier including all pronunciation rules and metadata. - [List pronunciation dictionaries](https://blackbox.dasha.ai/docs/api-reference/pronunciationdictionaries/list-pronunciation-dictionaries.md): Retrieves all pronunciation dictionaries for your organization. Pronunciation dictionaries customize how agents pronounce specific words during conversations. - [Remove pronunciation rules](https://blackbox.dasha.ai/docs/api-reference/pronunciationdictionaries/remove-pronunciation-rules.md): Removes pronunciation rules from an existing dictionary. After removing rules, automatically updates all agents using this dictionary with the new configuration. - [Delete provider](https://blackbox.dasha.ai/docs/api-reference/providers/delete-provider.md): Deletes a provider integration and performs complete cascade cleanup including: removal of all associated phone numbers, SIP credentials, and external resources (SIP trunks, credential lists). This operation is irreversible and will affect any agents using phone numbers from this provider. - [Get provider](https://blackbox.dasha.ai/docs/api-reference/providers/get-provider.md): Retrieves a specific provider integration by its unique identifier. Returns the appropriate derived type based on the provider type, including provider-specific configuration details. The response uses polymorphic serialization with the providerType discriminator. - [List providers](https://blackbox.dasha.ai/docs/api-reference/providers/list-providers.md): Retrieves all VoIP provider integrations for your organization with support for pagination. Returns polymorphic responses with provider-specific details based on the provider type. The providerType field acts as a discriminator to identify the specific provider implementation. - [Verify provider](https://blackbox.dasha.ai/docs/api-reference/providers/verify-provider.md): Triggers a comprehensive verification of the provider integration. Validates credentials, checks SIP trunk configuration, verifies credential lists, and confirms phone number attachments. Updates the provider's verification status and returns detailed check results for troubleshooting. - [Search within a multi knowledge bases](https://blackbox.dasha.ai/docs/api-reference/search/search-within-a-multi-knowledge-bases.md) - [Create SIP credential](https://blackbox.dasha.ai/docs/api-reference/sipcredentials/create-sip-credential.md): Creates new SIP credentials for authenticating with a SIP trunk provider. The credentials can be associated with phone numbers to enable inbound and outbound calling through the SIP provider's infrastructure. - [Delete SIP credential](https://blackbox.dasha.ai/docs/api-reference/sipcredentials/delete-sip-credential.md): Deletes a SIP credential from your organization. If the credential is associated with phone numbers, use the force parameter to automatically delete all associated phone numbers before deleting the credential. - [Get agents using SIP credential](https://blackbox.dasha.ai/docs/api-reference/sipcredentials/get-agents-using-sip-credential.md): Returns a list of agents that use phone numbers associated with this SIP credential, grouped by phone number. Also includes the count of calls currently in queue that use these credentials. - [Get SIP credential](https://blackbox.dasha.ai/docs/api-reference/sipcredentials/get-sip-credential.md): Retrieves a specific SIP credential by its unique identifier including server configuration, authentication details, and associated phone numbers. - [List SIP credentials](https://blackbox.dasha.ai/docs/api-reference/sipcredentials/list-sip-credentials.md): Retrieves all SIP credentials for your organization with support for pagination and search. SIP credentials store authentication information for connecting to SIP trunk providers, including server addresses, usernames, passwords, and optional TLS settings. - [Update SIP credential](https://blackbox.dasha.ai/docs/api-reference/sipcredentials/update-sip-credential.md): Updates an existing SIP credential configuration. This is a full replacement operation (PUT) that updates all credential settings including server address, authentication details, and transport protocol. - [Create phone number](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/create-phone-number.md): Creates a new SIP phone number in your organization. The phone number can be linked to an agent for inbound call handling. - [Delete phone number](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/delete-phone-number.md): Deletes a SIP phone number from your organization. If the phone number is linked to agents, use the force parameter to automatically remove the link before deletion. - [Get agents using phone number](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/get-agents-using-phone-number.md): Returns a list of agents that use this SIP phone number. Phone numbers can be used for both inbound call routing (linked agent) and outbound calls (agents configured to use this number for making calls). - [Get phone number](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/get-phone-number.md): Retrieves a specific SIP phone number by its unique identifier including linked agent information if applicable. - [Link phone number to agent](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/link-phone-number-to-agent.md): Links a SIP phone number to an agent for handling inbound or outbound calls. If the phone number was previously linked to another agent for inbound, it will automatically unlink from the previous agent and link to the new one. For outbound, replaces the agent's current outbound phone number (only on… - [List phone numbers](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/list-phone-numbers.md): Retrieves all SIP phone numbers for your organization with support for pagination and filtering. Filter by phone number, linked agent, or unlinked status. - [Unlink phone number from agent](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/unlink-phone-number-from-agent.md): Removes the link between a SIP phone number and its associated agent. After unlinking inbound, calls to this number will not be routed to any agent. After unlinking outbound, the agent will no longer use this number for outbound calls. - [Update phone number](https://blackbox.dasha.ai/docs/api-reference/sipphonenumbers/update-phone-number.md): Updates an existing SIP phone number configuration. This is a full replacement operation (PUT) that updates all phone number settings. - [Run one stateless text-chat completion turn.](https://blackbox.dasha.ai/docs/api-reference/textchat/run-one-stateless-text-chat-completion-turn.md): Statelessness: the client carries an opaque encrypted `state` blob between turns. The server decodes the state, drives the agent's orchestration loop (OpenAI ChatCompletions + tool calls — built-in, agent-defined webhook, or MCP), and returns the new messages plus a fresh encrypted state. The conver… - [Create Twilio provider](https://blackbox.dasha.ai/docs/api-reference/twilioprovider/create-twilio-provider.md): Creates a new Twilio provider integration with automatic SIP trunk configuration. Validates credentials with Twilio, creates a SIP trunk, sets up credential lists, and generates SIP credentials for call routing. All credentials are encrypted before storage. - [Get Twilio provider](https://blackbox.dasha.ai/docs/api-reference/twilioprovider/get-twilio-provider.md): Retrieves a specific Twilio provider integration with all Twilio-specific configuration details. Returns the complete provider configuration including AccountSid, TrunkSid, TerminationUri, Region, and call transfer settings. For a generic provider response without Twilio-specific fields, use the GET… - [Import phone numbers](https://blackbox.dasha.ai/docs/api-reference/twilioprovider/import-phone-numbers.md): Imports phone numbers from Twilio into the system for use with agents. Attaches each number to the provider's SIP trunk and creates local records for call routing. Supports partial success - continues importing remaining numbers if some fail. - [List available phone numbers](https://blackbox.dasha.ai/docs/api-reference/twilioprovider/list-available-phone-numbers.md): Retrieves all phone numbers from the connected Twilio account. Each number includes an imported flag indicating whether it has already been imported into the system. Use this endpoint to discover numbers before importing them. - [Remove phone number](https://blackbox.dasha.ai/docs/api-reference/twilioprovider/remove-phone-number.md): Removes an imported phone number from the provider. Detaches the phone number from the Twilio SIP trunk and deletes it from the system. The phone number remains in your Twilio account and can be imported again later. - [Update Auth Token](https://blackbox.dasha.ai/docs/api-reference/twilioprovider/update-auth-token.md): Updates the Auth Token for an existing Twilio provider. The new token is validated with Twilio before being saved to ensure it is correct. If validation fails, an error is returned and no changes are made. - [Update Twilio provider](https://blackbox.dasha.ai/docs/api-reference/twilioprovider/update-twilio-provider.md): Updates an existing Twilio provider configuration. Only provided fields are updated. Credentials (Account SID, Auth Token) cannot be updated through this endpoint for security reasons. Create a new provider if you need to change credentials. - [Clone voice from audio](https://blackbox.dasha.ai/docs/api-reference/voice/clone-voice-from-audio.md): Creates a custom cloned voice from audio samples. The system analyzes the audio characteristics and generates a synthetic voice that mimics the original speaker. The cloned voice becomes available in your organization's voice library for use in agents. - [Delete cloned voice](https://blackbox.dasha.ai/docs/api-reference/voice/delete-cloned-voice.md): Permanently deletes a custom cloned voice from your organization's voice library. The voice will become unavailable for use in agent configurations and synthesis requests. - [List available voices](https://blackbox.dasha.ai/docs/api-reference/voice/list-available-voices.md): Retrieves all available Text-to-Speech (TTS) voices for your organization including both public voices and custom cloned voices. Each voice includes metadata such as language, gender, description, and audio preview URLs for agent configuration. - [Synthesize text to speech](https://blackbox.dasha.ai/docs/api-reference/voice/synthesize-text-to-speech.md): Converts text to speech audio using the specified voice configuration. Returns MP3 audio ready for playback or download. Useful for voice preview during agent configuration and testing voice quality before deployment. - [Update cloned voice](https://blackbox.dasha.ai/docs/api-reference/voice/update-cloned-voice.md): Updates the metadata of an existing cloned voice without changing the underlying voice model. Only provided fields are updated while others remain unchanged. - [Test webhook endpoint](https://blackbox.dasha.ai/docs/api-reference/webhooktest/test-webhook-endpoint.md): Tests a webhook endpoint with realistic payload simulation. Sends a test payload to the webhook URL and validates the response. Returns test results including HTTP status, response data, and execution time. - [Create integration token](https://blackbox.dasha.ai/docs/api-reference/webintegrations/create-integration-token.md): Generates a new access token for the web integration. Tokens are used to authenticate external systems accessing the integration. - [Create web integration](https://blackbox.dasha.ai/docs/api-reference/webintegrations/create-web-integration.md): Creates a new web integration for an agent with configured features and access tokens. Web integrations allow external systems to interact with agents through APIs. - [Delete integration token](https://blackbox.dasha.ai/docs/api-reference/webintegrations/delete-integration-token.md): Revokes and removes an access token from the web integration. External systems using this token will immediately lose access. - [Delete web integration](https://blackbox.dasha.ai/docs/api-reference/webintegrations/delete-web-integration.md): Permanently deletes a web integration and revokes all associated access tokens. - [Get web integration](https://blackbox.dasha.ai/docs/api-reference/webintegrations/get-web-integration.md): Retrieves a specific web integration by its identifier including configuration settings and associated tokens. - [Get web integrations by agent](https://blackbox.dasha.ai/docs/api-reference/webintegrations/get-web-integrations-by-agent.md): Retrieves all web integrations associated with a specific agent. - [List web integrations](https://blackbox.dasha.ai/docs/api-reference/webintegrations/list-web-integrations.md): Retrieves all web integrations configured for your organization including configuration settings and associated tokens. - [Update web integration](https://blackbox.dasha.ai/docs/api-reference/webintegrations/update-web-integration.md): Updates an existing web integration configuration including features, origins, and settings. - [Validate integration token](https://blackbox.dasha.ai/docs/api-reference/webintegrations/validate-integration-token.md): Validates an access token and retrieves the associated integration configuration. This is a public endpoint used by external systems to discover integration settings. Validates both token validity and origin restrictions. - [Get WebSocket endpoint information](https://blackbox.dasha.ai/docs/api-reference/websocket/get-websocket-endpoint-information.md): Returns information about available WebSocket endpoints and their current status. - [WebSocket endpoint for web calls](https://blackbox.dasha.ai/docs/api-reference/websocket/websocket-endpoint-for-web-calls.md): Establishes a WebSocket connection for real-time web-based calls. This is not a traditional HTTP endpoint - it upgrades to WebSocket protocol. - [Build a Complete Agent in 10 Minutes](https://blackbox.dasha.ai/docs/create/creating-your-first-agent.md): Build a working AI voice agent in 10 minutes with the dashboard wizard or API. Step-by-step configuration of system prompt, LLM, voice, tools, and scheduling. - [Choose and Configure Language Models](https://blackbox.dasha.ai/docs/create/llm-configuration.md): Choose and configure language models from Dasha Reflex-1, OpenAI, Groq, xAI Grok, DeepSeek, or custom providers for your AI voice agents. - [Connect to MCP Servers for Pre-Built Tools](https://blackbox.dasha.ai/docs/create/mcp-connections.md): Connect Model Context Protocol servers to expand your agent's capabilities with pre-built tools and external data sources. - [Set Business Hours and Availability](https://blackbox.dasha.ai/docs/create/scheduling-availability.md): Configure business hours, timezone settings, and availability rules to control when your agent handles calls. - [Add External API Integrations](https://blackbox.dasha.ai/docs/create/tools-and-functions.md): Enable agents to call external APIs, query databases, and perform actions during conversations using function calling. - [TTS Providers Reference](https://blackbox.dasha.ai/docs/create/tts-providers.md): Detailed configuration for ElevenLabs, Cartesia, Inworld, and LMNT text-to-speech providers. - [Configure Voice and Speech](https://blackbox.dasha.ai/docs/create/voice-and-speech.md): Configure how your agent sounds. Choose a TTS provider, select a voice, and adjust speed settings. - [Caller ID Configuration](https://blackbox.dasha.ai/docs/deploy/caller-id.md): Configure caller ID for outbound calls. Set display names, follow compliance requirements, and improve answer rates. - [Deploy Voice Agents for Production](https://blackbox.dasha.ai/docs/deploy/deployment-overview.md): Deploy voice agents for phone calls. Configure SIP trunks and production settings. - [Receive Inbound Calls on Your Agent](https://blackbox.dasha.ai/docs/deploy/inbound-calls.md): Route phone calls to your AI agent. Link phone numbers for automatic call routing and handle business hours. - [Make Outbound Calls via API](https://blackbox.dasha.ai/docs/deploy/outbound-calls.md): Schedule outbound calls through the API. Link phone numbers for caller ID, set priorities, and run campaigns at scale. - [Connect Phone Numbers to Your Agents](https://blackbox.dasha.ai/docs/deploy/phone-numbers.md): Add phone numbers for inbound and outbound calls. Connect via Twilio integration or manually configure SIP credentials from any provider. - [Production Checklist](https://blackbox.dasha.ai/docs/deploy/production-checklist.md): Essential verification steps before launching your voice AI agent to production. - [SIP Credentials and Trunk Configuration](https://blackbox.dasha.ai/docs/deploy/sip-configuration.md): Configure SIP trunk credentials for connecting to any VoIP provider. Set up authentication, transport protocols, and rate limiting. - [Embed Voice and Chat Widgets on Your Website](https://blackbox.dasha.ai/docs/deploy/web-widget-embedding.md): Embed AI voice and chat widgets on your website. Add conversational AI to any page with a simple script tag. - [Configure Widget Security and Features](https://blackbox.dasha.ai/docs/deploy/widget-configuration.md): Configure web widget security, features, and appearance. Manage tokens, origin restrictions, and feature toggles. - [Customize Widget Appearance and Behavior](https://blackbox.dasha.ai/docs/deploy/widget-customization.md): Customize widget appearance, themes, and behavior. Use CSS variables and JavaScript API for advanced control. - [Account Settings](https://blackbox.dasha.ai/docs/introduction/account-settings.md): Manage your Dasha BlackBox account, invite team members, and configure roles and permissions. - [Configure Your Voice Agent](https://blackbox.dasha.ai/docs/introduction/agents.md): Learn how to configure AI voice agents in Dasha BlackBox — system prompts, LLM configuration, voice settings, and agent states. - [Understand Conversation Types and States](https://blackbox.dasha.ai/docs/introduction/conversations.md): Learn about conversation types in Dasha BlackBox — inbound calls and outbound calls. Understand conversation states and what gets recorded. - [Understand Agents, Tools, and Webhooks](https://blackbox.dasha.ai/docs/introduction/core-concepts.md): The four things you need to understand before building with Dasha BlackBox — agents, conversations, tools, and webhooks. - [Glossary](https://blackbox.dasha.ai/docs/introduction/glossary.md): Definitions for Dasha BlackBox platform terminology. Quick reference for agents, conversations, tools, webhooks, and voice AI concepts. - [Create Your First Voice Agent in 5 Minutes](https://blackbox.dasha.ai/docs/introduction/quickstart.md): Create a voice agent and test it in your browser — 5 minutes, no phone number required. - [Enable Agent Actions with Tools](https://blackbox.dasha.ai/docs/introduction/tools.md): Learn how to define tools that let your Dasha BlackBox agent take actions — check order status, book appointments, look up customer data, and more. - [Receive Event Notifications with Webhooks](https://blackbox.dasha.ai/docs/introduction/webhooks.md): Learn how webhooks notify your server when things happen in Dasha BlackBox — call started, call ended, tool execution, and more. - [Build AI Voice Agents for Phone and Web](https://blackbox.dasha.ai/docs/introduction/what-is-blackbox.md): Build AI voice agents that handle phone calls and web conversations. Create an agent in 5 minutes, deploy with real phone numbers, scale to thousands of concurrent calls. - [Activity Logs](https://blackbox.dasha.ai/docs/monitor/activity-logs.md): Track every action in your organization: webhooks, tool calls, API requests, agent changes, and call lifecycle events. Search, filter, and analyze with full-text search and aggregations. - [Call History](https://blackbox.dasha.ai/docs/monitor/call-history.md): View, filter, and search past calls. Access transcripts, recordings, and detailed call information through the dashboard or API. - [Monitor Concurrent Call Capacity](https://blackbox.dasha.ai/docs/monitor/concurrency-monitoring.md): Monitor concurrent call capacity, track utilization metrics, set up alerts, and plan scaling strategies for optimal voice AI performance. - [Analyze Completed Calls](https://blackbox.dasha.ai/docs/test/call-inspector.md): Access the Call Inspector to analyze transcripts, audio recordings, LLM interactions, tool executions, and performance metrics for any completed call. - [Test Agents in the Browser](https://blackbox.dasha.ai/docs/test/dashboard-testing.md): Test voice agents in the browser without phone calls. Run voice or chat conversations with real-time transcripts and validate behavior before deployment. - [Validate Your Agent Before Deployment](https://blackbox.dasha.ai/docs/test/testing-overview.md): Test voice AI agents before deployment using browser testing, API calls, and debugging tools. Validate conversation quality, voice experience, and integrations. - [Fix Common Agent and API Problems](https://blackbox.dasha.ai/docs/troubleshooting/common-issues.md): Quick solutions for the most common Dasha BlackBox problems: agent issues, API errors, webhooks, and voice quality - [Set Up Webhook Endpoints](https://blackbox.dasha.ai/docs/webhooks-and-events/configuring-webhooks.md): Configure webhook URLs, authentication headers, and event types through the dashboard or API. - [Test Webhook Endpoints Before Going Live](https://blackbox.dasha.ai/docs/webhooks-and-events/testing-webhooks.md): Test webhook endpoints locally with ngrok, validate payloads, and verify security before production deployment. - [Webhook Payload Types and Schemas](https://blackbox.dasha.ai/docs/webhooks-and-events/webhook-events.md): Complete reference for webhook payload types, structures, and response formats based on the actual API schema. - [Receive Real-Time Event Notifications](https://blackbox.dasha.ai/docs/webhooks-and-events/webhooks-overview.md): Real-time event notifications and integration with external systems. Receive instant HTTP callbacks when calls complete, fail, or require tool execution. - [Build a Real-Time Text Chat Interface](https://blackbox.dasha.ai/docs/websockets/chat-implementation.md): Build real-time text chat with AI agents using WebSocket connections for instant messaging. - [Error Handling](https://blackbox.dasha.ai/docs/websockets/error-handling.md): WebSocket error messages and recovery. - [WebSocket Message Types and Schemas](https://blackbox.dasha.ai/docs/websockets/message-reference.md): Complete reference for all WebSocket message types, schemas, and their JSON structures. - [Execute Agent Tools in the Browser](https://blackbox.dasha.ai/docs/websockets/tool-execution.md): Handle agent tool calls via WebSocket for real-time browser-based function execution. - [Implement Browser-Based Voice Calls with WebRTC](https://blackbox.dasha.ai/docs/websockets/voice-call-implementation.md): Build browser-based voice calls with AI agents using WebRTC and WebSocket signaling. - [Build Real-Time Voice and Chat Experiences](https://blackbox.dasha.ai/docs/websockets/websockets-overview.md): Build real-time voice and chat experiences with AI agents using WebSocket connections for instant bidirectional communication. ## OpenAPI Specs - [swagger](https://blackbox.dasha.ai/swagger/v1/swagger.json) - [openapi](https://blackbox.dasha.ai/api-reference/openapi.json) ## Optional - [Status](https://status.dasha.ai)