DialNexa

Permanently deletes an agent and detaches every phone number assigned to it, so inbound calls to those numbers are no longer answered by it. It is refused while an active workflow uses the agent, or while one of its numbers has an unfinished batch or a call in progress. This is NOT reversible. Only call this after the user has explicitly confirmed they want THIS specific agent deleted — never as a guess, and never in response to an ambiguous request. Use get_agent first to confirm you have the right one. Requires confirm: true — only set this after the user has given explicit approval in this conversation, never preemptively.

delete_agent

Deletes a campaign from the organization's list — the same delete the dashboard offers on a draft campaign. Removes the campaign only; calls it already placed keep their own records. Allowed for campaigns that are not live: draft, completed, or cancelled. A campaign that is still going (running, paused, scheduled, waiting) CANNOT be deleted — cancel it first with update_batch_call_status, then delete. Requires confirm: true, and this cannot be undone.

delete_campaign

Permanently deletes a knowledge base and its documents. This is NOT reversible, and fails if the knowledge base is still attached to any agent. Requires confirm: true — only set this after the user has explicitly approved deleting this specific knowledge base, never preemptively.

delete_knowledge_base

Deletes a folder. The agents inside it are not deleted; they become unfiled. Requires confirm: true.

delete_organization_folder

Releases/deletes one of the organization's phone numbers. This is NOT reversible. Refused while calls are live on the number, while a batch that is not completed or cancelled dials from it, or while an active workflow uses it. Use get_organization_phone_number first to confirm you have the right one. Requires confirm: true — only set this after the user has explicitly approved removing this specific number, never preemptively.

delete_phone_number

Unlinks a phone number from an agent for one direction. Refused while calls are live on the number, while a batch that is not completed or cancelled dials from it (change that batch's number or cancel it first), or while an active workflow uses it.

remove_agent_phone_number

Disconnects an integration. This takes effect immediately — anything currently relying on this connection (agent functions, workflow application nodes) will stop working until it's reconnected. Reversible by reconnecting, but not instantaneous (the user has to go through the connect flow again), so requires confirm: true — only set this after the user has explicitly approved disconnecting this specific integration, never preemptively.

disconnect_integration

Clones an existing agent — copies its current version's prompt and every setting into a brand-new agent. Reversible: the copy is an unpublished DRAFT that makes no calls, and the original is untouched. Deliberately does NOT copy the phone-number binding, so the clone never starts answering the original's number. Use it for "make a copy of X so I can tweak it" or "same agent but for the Hindi market". Resolve the source with list_agents first.

duplicate_agent

Returns full configuration for a single agent by ID (e.g. agent_abc123), including all versions with their functions, pronunciations, and post-call analysis config. Use list_agents first if you don't already have the ID.

get_agent

Returns the catalog of building blocks available to the agent builder — LLMs, transcribers, languages, and other resolver options usable when configuring an agent.

get_agent_builder_inventory

Returns details for a single agent template by ID. Use list_templates first if you don't already have the ID.

get_template

Returns full configuration for a single version of an agent, given its agent_id and version_number, including functions, voice, LLM, and transcriber config.

get_agent_version

Returns the email addresses that receive this organization's balance and spend alerts. An empty list means alerts fall back to the organization owner.

get_billing_alert_emails

Returns full details for a single call by its ID (e.g. call_abc123). Use list_calls first if you don't already have the ID.

get_call

Returns what actually HAPPENED on one call: its transcript, the post-call summary, notes, the recording link, warm-transfer details and audio-cache use. This is the only way to read a SINGLE call's transcript — get_call returns metadata (status, duration, cost) but never the conversation. Use it for "what did the agent say on that call?", "why did this one go wrong?", or to quote a caller's own words. Transcripts can be long; ask only for the fields you need. The recording link is returned only with include_recording: true, which you set only when the user explicitly asks for the audio.

get_call_details

Returns the retry attempts made for a call, given the ORIGINAL (parent) call id. Retries are separate call records with no batch id of their own, so they do not show up in list_calls_in_batch or campaign counts — this is the only way to see them. Use it for "did it try again?", "how many attempts did this lead get?", or when a campaign's numbers do not add up. An empty list means no retries were made.

get_call_retries

Returns whether a call was handed to a human (warm transfer) and how that went — which sessions were attempted and their status. Answers "did this reach a person?". Calls whose agent has no transfer step report had_call_transfer_node: false.

get_call_transfer

Returns details for a single campaign by ID (e.g. batch_abc123). Use list_campaigns first if you don't already have the ID.

get_campaign

Returns the current control status (running/paused/completed/etc.) and available actions for a campaign, given its batch_id.

get_campaign_status

Returns the organization's call/agent/onboarding summary stats — the same numbers shown on the dashboard home page.

get_dashboard_stats

Returns the organization's call volume for each of the last 7 days.

get_dashboard_weekly_stats

Returns the organization's external webhooks — the endpoints DialNexa posts call results to, and their settings. Answers "where do my call results go?" and "is a webhook set up?". Separate from list_user_webhooks, which covers per-agent webhooks. URLs show only their host; the full URL is in the dashboard.

get_external_webhook

Returns the agents that currently use this knowledge base. Call it BEFORE proposing delete_knowledge_base or any change to a KB, so the user is told which agents lose that knowledge by name rather than in the abstract. An empty list means nothing is attached and deleting is safe.

get_knowledge_base_affected_agents

Returns a single knowledge base document by ID (e.g. kb_abc123). Use list_knowledge_base_documents first if you don't already have the ID.

get_knowledge_base_document

Returns details for a single LLM by ID (e.g. llm_abc123). Use list_llms first if you don't already have the ID.

get_llm

Returns details for a single language by ID (e.g. lang_abc123). Use list_languages first if you don't already have the ID.

get_language

Returns basic details (name, plan, settings) about one organization this credential may use. When the token has several organizations, pass organization_id (from list_my_organizations). When it has one, this returns that organization with no arguments.

get_my_organization

Returns details for one of the organization's phone numbers by ID (e.g. phn_abc123).

get_organization_phone_number

Returns the ACTIVE workflows that dial through this phone number. Call it BEFORE proposing delete_phone_number or reassigning a number, so the user knows what stops working — releasing a number that a live workflow calls through breaks that workflow mid-run. An empty list means nothing active depends on it. Paused workflows are deliberately excluded: they are not blocking.

get_phone_number_active_workflows

Returns pending AI-generated prompt improvement suggestions for a specific agent, based on recent call analysis.

get_prompt_suggestions_for_agent

Returns the organization's monthly spend cap and how much of it is used, how much has been spent so far this month, when the month resets, and its two low-balance email alerts — all in INR. Months are calendar months in IST. Pair this with get_wallet_balance for any "how much can I still spend" question: once this month's spend reaches monthly_spend_cap_inr, new calls, phone number renewals and purchases are refused until reset_date, however large the wallet. A null cap means no cap is set. The two alert fields only send emails and never block spending.

get_spend_limits

Returns details for a single transcriber by ID (e.g. trs_abc123). Use list_transcribers first if you don't already have the ID.

get_transcriber

Returns details for a single webhook by ID (e.g. webhook_abc123). Secret is masked. The URL shows only its host; the full URL is in the dashboard.

get_user_webhook

Returns details for a single voice by ID (e.g. voice_abc123). Use list_voices first if you don't already have the ID.

get_voice

Returns the languages a specific voice supports, given its voice ID.

get_voice_languages

Returns the organization's current billing wallet balance in INR — the money left to spend on calls. This is the SAME balance the dashboard sidebar shows, and it is the tool to use for any "how many credits / how much balance do I have left" question. The other billing tools return the plan and rate CATALOG, not what is left. If this organization has no billing_wallets row, this reports that explicitly rather than returning zero.

get_wallet_balance

Returns details for a single workflow by ID (e.g. workflow_abc123). Use list_workflows first if you don't already have the ID.

get_workflow

Returns the full execution history for one lead within a workflow — every step it passed through, timestamps, and current status. Use list_workflow_leads first to find the lead_id.

get_workflow_lead_history

Returns the distinct dynamic variable names (from the uploaded lead CSV columns) available for a workflow's leads — e.g. to know what personalization fields exist.

get_workflow_lead_variable_keys

Returns all nodes and edges currently in a workflow's graph — use this to see the workflow's steps and how they connect, and to check it is complete before it is activated in the dashboard (confirm START has one outgoing edge and no incoming edges, every other node is reachable from START, and a CONVERTED and DROPPED node both exist and are connected).

get_workflow_structure