GET /api/v1/voice_agents/new
Return a new AI Agent object pre-populated with default values (not persisted).

Params

Param name
Description
Validations
name
Optional Blank Value Allowed

Name – Internal name for the AI Agent. Used for identification within the platform.

Validations:

  • Must be a String
description
Optional Blank Value Allowed

Description – Short summary describing the purpose and behavior of the AI Agent.

Validations:

  • Must be a String
system_prompt
Optional Blank Value Allowed

System Prompt – Global instruction set applied to all flows in this AI Agent. Defines tone, rules, and constraints.

Validations:

  • Must be a String
conversation_timeout
Optional Blank Value Allowed

Conversation Timeout Default – Default per-prompt timeout (in seconds) before the conversation ends if no response is received. Resets after each prompt unless overridden by a flow.

Validations:

  • Must be a decimal number.