> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents overview

> Create, configure, publish, inspect, and retire DialNexa v1 agents.

Agents combine prompts, language, voice, model, transcription, analysis, and telephony settings. Calls use a published agent version; a newly created agent starts with draft version 1.

## Lifecycle

| Stage        | Operation                                                                                  | What happens                                                                      |
| ------------ | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| Create draft | [Create Agent](/docs/api-reference/v1/agents/create)                                            | Creates the agent and version 1.                                                  |
| Configure    | [Update Agent](/docs/api-reference/v1/agents/update)                                            | Changes a draft version and can attach knowledge bases or phone numbers.          |
| Publish      | [Update Agent](/docs/api-reference/v1/agents/update)                                            | Send `version_number` and `is_published: true` before live calls.                 |
| Use          | [Create Call](/docs/api-reference/v1/calls/create)                                              | Starts a call with the latest published version or a specified published version. |
| Inspect      | [List Agents](/docs/api-reference/v1/agents/list) and [Get Agent](/docs/api-reference/v1/agents/get) | Lists lightweight records or fetches all version details.                         |
| Retire       | [Delete Agent](/docs/api-reference/v1/agents/delete)                                            | Removes the agent from normal use. Review active routing first.                   |

## Minimal agent

A single-prompt agent needs `title`, `language_id`, `voice_id`, and `prompt_text`. Fetch catalog IDs from [Languages](/docs/api-reference/v1/languages/list) and [Voices](/docs/api-reference/v1/voices/list). 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 phone-number assignment as a routing change, not display metadata.
* Test dynamic variables with the same keys you will send in call `metadata`.
* Fetch one agent when you need functions and complete version details.

## Capabilities not exposed as public v1 operations

Some dashboard agent-management actions remain dashboard-only or legacy during the v1 transition. Use the operations listed on this page for new public integrations and see [Migrating to v1](/docs/api-reference/v1/migrating-to-v1) before relying on a legacy route.