Skip to main content
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

​
Minimal agent

A single-prompt agent needs title, language_id, voice_id, and prompt_text. 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 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 before relying on a legacy route.