Skip to main content
POST
Duplicate agent into another project

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

agent_id
string<uuid>
requerido

Cuerpo

application/json
target_project_id
string<uuid>
requerido

Project where the duplicated agent draft will be created

source_version_id
string<uuid> | null

Specific source version to duplicate. Defaults to the current draft.

name
string | null

Optional name for the duplicated agent. Defaults to "{original} (copy)".

Respuesta

Successful Response

agent_id
string<uuid>
requerido

The unique identifier for the agent

modified_at
string<date-time>
requerido

The date and time when the agent was last updated

created_at
string<date-time>
requerido

The date and time when the agent was created

version_id
string<uuid>
requerido

The version id of the agent

version_number
integer
requerido

The version number of the agent

version_created_at
string<date-time>
requerido

The date and time when the version was created

realtime_provider
enum<string>
requerido

Primary realtime provider. Use this to filter GET /v1/voice/.

Opciones disponibles:
gemini,
grok,
gpt_live
voice
Voice · object
requerido

The voice object used by the agent

language
enum<string>
requerido

The language used by the agent. Use multi for the agent using both english and spanish in the same call (multi will expand to more languages in the future)

Opciones disponibles:
es,
en,
multi,
ar,
be,
bn,
bs,
bg,
ca,
hr,
cs,
da,
nl,
et,
fi,
nl-BE,
fr,
de,
de-CH,
el,
he,
hi,
hu,
id,
it,
ja,
kn,
ko,
lv,
lt,
mk,
ms,
mr,
no,
fa,
pl,
pt,
ro,
ru,
sr,
sk,
sl,
sv,
tl,
ta,
te,
tr,
uk,
ur,
vi
mode
enum<string>
requerido

The mode of the agent. Can be 'free' or 'path'

Opciones disponibles:
free,
path
version_name
string | null

The version name of the agent

is_draft
boolean
predeterminado:false

Indicates if the agent is a draft version

is_published
boolean
predeterminado:false

Indicates if the agent is published

name
string | null

The name of the agent

description
string | null

The description given to the agent

prompt
string | null

Shared task and business instructions for the agent

voice_prompt
string | null

FREE mode only: speaking style and conversational instructions. GPT Live sends this only to the voice model; single-model providers combine it with the shared prompt.

backend_prompt
string | null

FREE mode only: tool execution and validation instructions. GPT Live sends this only to the backend model; single-model providers combine it with the shared prompt.

greeting
string | null

The greeting message said by the agent to the caller at the beginning of the call. If set, the agent will always speak first both in inbound and outbound calls

time_before_start
number | null

The time in seconds before the agent starts to speak

thinking_level
enum<string> | null

Reasoning level for an agent version. Unset in the DB means MINIMAL.

Gemini Live applies it as its thinking level, GPT-Live as the backend Responses model's reasoning effort, Grok as reasoning on/off.

Opciones disponibles:
MINIMAL,
LOW,
MEDIUM,
HIGH
volume
integer
predeterminado:50

Controls the output volume of the agent's voice. 50 is the default (no change), 0 is silent, 100 is maximum gain.

Rango requerido: 0 <= x <= 100
max_reminder_count
integer
predeterminado:3

The maximum number of reminders that can be sent to the caller. If not provided, the default value is 3. Set this value to 0 to disable reminders

Rango requerido: x >= 0
reminder_frequency_ms
integer
predeterminado:7500

The frequency in milliseconds to send reminders to the caller. If not provided, the default value is 7500.

reminder_messages
string[]

The list of messages to send to the caller as reminders. If not provided, the default value is an empty list which makes the model to generate the reminder messages by itself. Please, note that when using an empty list, the reminder_frequency_ms can be a little bit higher than specified since it has to generate the messages

knowledge_base_ids
string<uuid>[] | null

The list of knowledge bases available for the agent to use

knowledge_item_ids
string<uuid>[] | null

The list of knowledge items directly available for the agent to use

conversational_path_id
string<uuid> | null

The id of the conversational path used by the agent.

integrations
IntegrationToolsResponse · object[]

The list of integrations and their assigned tools for the agent

call_tools
(TransferCallToolSchema · object | HangUpToolSchema · object)[]

The list of call-tools (built-in tools) assigned to the agent

Transfer a call to another number.

Wire shape (FLAT, all fields top-level):

dynamic_variables
Dynamic Variables · object | null

Agent-level dynamic variables for template interpolation. Overridden by call-level variables.

background_audio
enum<string> | null

The background audio to be used in the calls that this agent handles

Opciones disponibles:
call_center,
cafe,
road_traffic,
park,
office,
car_garage
flows
FlowInfoResponse · object[]

Detailed flow info assigned to the agent

source_template_id
string<uuid> | null

The ID of the agent template this agent was created from

enable_recording
boolean
predeterminado:true

Record the audio of the calls this agent handles

enable_transcription
boolean
predeterminado:true

Store the transcript of the calls this agent handles. When disabled, conversation text is also kept out of call logs and traces

enable_contact_collection
boolean
predeterminado:true

Store the caller (or callee, on outbound calls) as a contact linked to the call. When disabled, calls are stored without a contact

voicemail_detection
boolean
predeterminado:false

Detect when an outbound call reaches a voicemail

voicemail_action
enum<string>
predeterminado:leave_message

What the agent does when a voicemail is detected

Opciones disponibles:
leave_message,
hang_up
voicemail_message
string | null

Message the agent leaves on the voicemail

phone_menu_detection
boolean
predeterminado:false

Detect and handle automated phone menus (IVR) on outbound calls

phone_menu_action
enum<string>
predeterminado:navigate

What the agent does when a phone menu is detected

Opciones disponibles:
navigate,
hang_up
phone_menu_navigation_mode
enum<string>
predeterminado:goal

How the agent navigates the menu: towards a goal or pressing a fixed key sequence

Opciones disponibles:
goal,
key_sequence
phone_menu_goal
string | null

Plain-language goal the agent navigates the menu towards

phone_menu_key_sequence
string | null

Comma-separated DTMF keys pressed in order, e.g. '1,3,5'

validation_issues
ValidationIssueSchema · object[] | null

List of issues that would prevent launching/publishing. Only present for draft versions on dashboard endpoints.