Documentation Index
Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt AI agents and IDE assistants can connect to the docs MCP server at: https://dialnexa.com/docs/mcp Use this file to discover all available pages before exploring further.
September 2026 update summary
DialNexa changelog for September 2026
30th September, 2026
Agent phone numbers
Phone numbers now link to an agent instead of an agent version. An agent can have up to three inbound and three outbound numbers, every version uses them, and inbound calls and workflow calls run on the latest published version. New endpoints list, attach, and detach numbers and return link history. Create Agent and Update Agent no longer accept phone number fields, and Get Agent Details returnsinbound_phone_numbers and outbound_phone_numbers.
Choose the outbound number for a call
Create Call and Create Batch Call acceptphone_number_id to pick one of the agent’s outbound numbers. It is required when the agent has more than one. A batch keeps its version and number after it leaves draft.
Edits while a batch is running
Publishing is no longer blocked by batches. While a batch is running on the agent, changes to a published version in place, its timezone, or its pipeline type return409 Conflict with code AGENT_HAS_RUNNING_BATCH.
MCP agent phone number tools
Four new MCP tools list, attach, and detach agent phone numbers and read their history.publish_agent no longer takes phone number arguments, and create_call, create_batch_call, and preview_batch_call_leads accept phone_number_id.
28th September, 2026
Auto-recharge setup and history
Configure auto-recharge in enabled workspaces, verify the card authorization, and review pending charges, settlement timing, and cancellation.SIP trunk validation
Validate a saved SIP trunk with a ringing probe, understand what the result proves, and choose whether to keep, delete, or correct a failed configuration.Concurrency capacity preview
Read guaranteed, inbound-reserved, and spare platform capacity in the redesigned bar. Preview whole-number settings and discard unsaved changes before applying them.Draft prompt size and publication
Over-limit Single Prompt and Speech to Speech drafts can be saved for editing. The selected model ceiling is enforced at publication.Agent versions and test targets
Check the live and editing version indicators. Phone tests use a published version, while browser testing can verify the open draft.Language findings in prompt review
Speech quality review now includes configured-language conflicts, number-format rules, and welcome-message script mismatches.Four-step batch preparation
Prepare Details, Recipients, Schedule, and Review before sending. Drafts retain future start times and request a new choice when a saved time has passed.Batch list start times
Distinguish actual and scheduled start times from batch creation time. Draft rows show N/A even when a future schedule is saved.Sarvam Saaras transcription
Choose Sarvam Saaras for supported languages, compare its response timing, and verify best-effort recognition hints using recordings and transcripts.Sarvam voice imports
Sarvam voices are available across workspaces through voice selection and Voice Config. Review compatible languages, voice models, and speed before publishing.Default number after KYC
KYC approval removes the shared default workspace number. Prepare your own purchased number and published agent routing before starting production calls.Graph navigation and workflow readiness
Review workflow validation issues before activation and distinguish unsaved edits from view changes. Agent and workflow graphs provide node search, start navigation, fit-all, and actual-size zoom.Workspace settings and AI app access
Open workspace administration from the main sidebar. AI app access is the new label for Connected Apps and remains separate from agent Integrations.Speech to Speech silence handling
Speech to Speech calls start silence timing after the welcome and retain the reminder state so unattended calls can end according to the saved silence rule.Short multilingual replies
Replies of up to three syllables carry forward the established conversation language, reducing unintended switches from brief greetings or acknowledgements.MCP catalog refreshed
Regenerated all 103 registered tools from the backend source. Agent tool descriptions now explain draft prompt health and publication limits; the voice provider input schema is refreshed.25th September, 2026
API reference now verified against the backend contract
The v1 reference is synced from the backend’s exported contract and checked in CI: every parameter and field the API validates, every response field an API key receives, and every declared status code. Four filters that never had any effect were removed from the docs (country_code and type on List Phone Numbers, is_active on List Webhooks, status on List Workflows). See List Phone Numbers, List Webhooks and List Workflows.Sorting on list endpoints
List Batch Calls and List Phone Numbers document sortBy and sortOrder, which the API always accepted. Unknown sort fields now return 400 instead of a server error, and the default page size for List Batch Calls is 30. See List Batch Calls and List Phone Numbers.Call settings on Update Agent
Update Agent documents the call settings it has always accepted: max_call_duration_sec, end_call_on_silence_sec, end_call_on_hold_sec, ring_duration_sec, pause_before_speaking_sec, voicemail_detection, hangup_on_voicemail, voicemail_message and pronunciations. The four keypad fields (listen_for_keypad, digit_limit, termination_key, keypad_timeout_sec) are deprecated: they are accepted and stored but not applied to calls, and will be removed. See Update Agent.Status codes corrected
Link SIP Trunk documents 502 for provider failures, Upload Document documents 409 and 413, Update Agent and Delete Knowledge Base document 409, and Purchase Phone Number no longer lists a 200 it never returned. The Agent Builder operations that create something (run, shape advisor, classify shape, generate objectives, generate agent tone) return 201; the inventory read and the streaming run keep 200.21st September, 2026
Multilingual language and voice selection
Choose a primary language and up to three secondary languages before selecting a shared compatible voice. Updated the selector and TTS guidance with captured language and voice-picker screens.Workspace voice imports
Added a Voice Config guide for searching and importing voices, reviewing My voices, and resolving blocked removal. Workspace navigation links to the new guide; screenshots show import results and the imported list.Workspace call concurrency
Added a Concurrency guide covering capacity, inbound reserve, a dynamic reserve, ceilings, and self-service purchase or release. Included settings and charge-preview screenshots, renewal behavior, and verification steps.Retrigger completed batches
Select recipients by their latest outcome, review short-call filters, and prepare a new batch from a completed or cancelled batch. Screenshots show filters and the prefilled review form.Review recipients after an agent change
Changing an agent or version on a new batch or draft requires another recipient review. The binding is locked after the batch leaves draft; use a new batch to change it.Devanagari name conversion
Added text-only guidance for Hindi name conversion, accepting or rejecting suggestions, rechecking edited rows, and recovering when conversion is unavailable. Clarified that AI name cleanup supports up to 1,000 contacts.Bulk country-code correction
Added text-only steps for prefixing eligible local numbers, protecting manual edits, resolving duplicate collisions, and validating the final recipient list.Knowledge document processing
Explained upload acceptance versus retrieval readiness, visible-tab status refresh, failed uploads, and corrected-file retries. The upload API now documents background indexing and processing fields.DOCX support and document limits
Documented PDF, TXT, and DOCX uploads with a 20 MB file and extracted-text limit, a 25-document limit, and unsupported legacy DOC files. Updated the upload API contract and errors.Google-first account screens
Added verified sign-in and sign-up screenshots, email disclosure instructions, required fields, and account verification guidance. Expanded email forms are described in text.Public multilingual API contracts
Added List Voice Language Options, bringing the reference to 73 operations. Documented all-selected-language voice filtering, workspace visibility, projected voice responses, and primary/secondary agent request fields.MCP language and indexing schemas
Regenerated the 103-tool reference from the reviewed backend commit. Agent inputs include secondary languages and an optional language message; knowledge uploads expose processing, ready, and failed states.Copied speech and analysis settings
Documented preservation of denoising strength, reminder wording, and the post-call extraction model during import or duplication, including normalization of older values.Language switching and number pronunciation
Explained explicit requests to switch among configured languages, primary-language fallback, identity questions, English transcription hints, and language-aware pronunciation checks for dates, amounts, and digit sequences.Ambient audio in web calls
Web calls can play configured ambient audio without treating background-only chunks as agent speech. Added practical audio verification guidance.Unanswered call classification
Originator-cancelled hangups are classified as user_did_not_pick_up rather than system_failure. Use the end reason alongside status when reviewing outcomes.Phone rental billing dates
Explained that displayed rental end dates follow subscription billing dates, including the first cycle, rather than assuming a calendar month.15th September, 2026
End Call on Hold
Configure a 10 to 60 second wait for a sustained detected hold, with a 20 second default for new agents. The control is separate from silence timing and hidden for IVR agents.Credit expiry and recharge balances
Review each recharge in Your credits, including its remaining balance and six-month expiry. The balance notice distinguishes the total expiring within 30 days from the first expiry date.Agent type filters and list labels
Call History now groups Single Prompt, Conversational Flow, and Speech to Speech agents under Dynamic and IVR under Static. Agents also shows an Agent type column. API clients can use agent_type while existing is_ivr requests remain supported.Saved businesses and assistant memory
Choose saved business context in Agent Builder, review recalled decisions from earlier assistant sessions, and optionally explain a rejected edit proposal. Business context is selected explicitly rather than applied to every agent.MCP memory and output schemas
The generated reference now covers 103 tools, including Get Memory. Wallet output includes expiry fields, and declared output schemas allow additional returned record fields.Agent field validation
Create and update requests validate individual function and post-call fields, including selector choices and unique names. Updated examples use TEXT and SELECTOR, and call timing and fallback delay bounds are documented.IVR pricing and prompt recovery
IVR pricing separates the plan IVR rate from telephony. Published menu audio can be restored from durable storage when its cache expires.Name cleanup failure guidance
Partial name checks retain usable suggestions and leave unchecked names unchanged. A failed check is reported as unavailable rather than as a clean result.Voice controls and personalized greetings
Removed the retired Voice Volume slider and its outdated screenshot. Voice pickers load in pages with sample-loading feedback. Personalized greetings use call-specific values and stay out of shared welcome caches.Multilingual reply behavior
Language tracking no longer depends on a populated Hinglish Map. Hindi substitutions are limited to appropriate Hinglish configurations, and compatible speech output follows the reply language.Imported agent settings
Import and duplicate preserve disabled Audio Cache and predictive preprocessing settings from the original agent. API imports can identify the imported payload with imported_from_file.Excel exports and help navigation
Call History exports preserve multilingual text and rupee symbols in Excel. The Need help menu groups links under References, Support, and Sales.7th September, 2026
Agent Builder build path and agent type recommendation
Create agent now opens a build path choice. Proceed to Agent Builder collects Goal & Context, Call Playbook, and Personality, then suggests an agent type you can override. Manual Build starts from a template or a blank configuration. Agent Builder can draft Single Prompt, Conversational Flow, Speech to Speech, and IVR agents.Agent type selection moved to Manual Build
The Dynamic Agents and Static Agents tabs have been replaced. Manual Build shows Single Prompt, Conversational Flow, and Speech to Speech cards, and Show the IVR agent reveals the IVR Agent card, still marked Beta.Prompt size limits and the editor meter
Single Prompt and Speech to Speech editors show an estimated token count with green, yellow, and red states. Every selectable model now has an enforced ceiling, and with a fallback enabled the tighter of the two applies. Publishing is blocked above the ceiling. As of 28 September, saving an over-limit draft remains available so it can be edited down.IVR handoff variables and branch labels
Each Connect To Agent node needs a non-empty fallback for every variable in its target’s published prompt, welcome message, voicemail message, and default map. Branches show their digit on the connecting line, and publishing warns about missing fallbacks. IVR calls record only the conversational portion after a handoff.Agent exports and imports drop phone bindings
Exports strip inbound and outbound phone bindings, including nested phone-provider objects, and import ignores bindings in older JSON files. IVR menu graphs are preserved. Assign phone numbers explicitly in the destination workspace after publishing.Workflow lead tags
Tag a lead cohort from the upload dialog or a reserved tags column. Tags are combined, lowercased, trimmed, and deduplicated, with at most 20 tags per lead and 40 characters per tag. Calls placed by the workflow copy the lead’s tags into the call record for Call History filtering.End Call is platform-managed
End Call appears automatically on new agents and cannot be edited or deleted. It does not on its own disable predictive preprocessing or require a tool-calling model. Those rules apply once you add callable functions.Recipient column mapping and duplicate rules
Two mapped columns cannot resolve to the same field name, and a mapped column wins over an unmapped source column of the same name. Duplicate removal uses the phone column you selected, and numeric Excel phone cells are converted to strings before validation.Batch retry count corrected to four
The retry count range is 0 through 4, so a recipient is called at most five times. The retry interval is in minutes, from 0 to 1440. The previous guidance said 5, which the API has never accepted.Knowledge base document API
Upload a PDF or TXT document to a knowledge base with an API key, and list a knowledge base’s documents. A knowledge base outside your workspace returns 404 rather than confirming the ID exists, because document listings carry each file’s full text.Public API reference expanded to 72 operations
Added API key validation, IVR transfer helper reads, agent version and function reads, agent type recommendation, and knowledge base documents. Every operation was checked against DialNexa’s own API definition, so the reference covers exactly the endpoints the platform publishes, with request fields, response envelopes, and errors. Endpoints the platform treats as internal are deliberately absent.Batch reads for API key callers
Get Batch Call Details and Update Batch Call Status return an empty object to API key callers because batch detail fields are filtered from the response. Use List Batch Calls for status and List Calls with batch_call_id for call records, or set export=true on the detail endpoint.Batch retry and filter parameters in the reference
Create Batch Call now listsnumber_of_retries and interval_between_retries as request fields with their accepted ranges, and Get Batch Call Details lists the is_ivr, tags and tags_match filters. The endpoints already accepted all five; only the reference was missing them. List Organization Folders gained export and Search Available Numbers gained region for the same reason.