Agents overview - DialNexa Documentation

Agents combine prompts, language, voice, model, transcription, analysis, and telephony settings. Calls use a published agent version. A newly created agent starts with one unpublished draft, version 0; each later version counts up from there.

Lifecycle

Stage	Operation	What happens
Create draft	Create Agent	Creates the agent and its first draft, version `0`.
Configure	Update Agent	Changes a draft version and can attach knowledge bases.
Publish	Update Agent	Send `version_number` and `is_published: true` before live calls.
Route	Attach Agent Phone Number	Links up to 3 inbound and 3 outbound numbers to the agent. Every version uses them.
Use	Create Call	Starts a call with the latest published version or a specified published version.
Inspect	List Agents and Get Agent	Lists every agent with its versions, or fetches one agent with its versions, functions, and phone numbers.
Retire	Delete Agent	Removes the agent from normal use. Review active routing first.

Minimal agent

A single-prompt agent needs only prompt_text; send title, language_id, and voice_id too, because DialNexa fills defaults for any you omit. Fetch catalog IDs from Languages and Voices. Advanced telephony, fallback, analysis, and speech settings are optional.

Production checklist

Publish the intended version before creating a call.
Use signed IDs exactly as returned, including prefixes.
Treat attaching or detaching a phone number as a routing change: inbound calls to an agent’s numbers run on its latest published version.
Test dynamic variables with the same keys you will send in call metadata.
Fetch one agent when you need functions and complete version details.

Dashboard-only capabilities

Some agent-management actions remain available only in the dashboard. Use the operations listed on this page for public API integrations, and use the dashboard when an action is not listed here.