Skip to main content
POST
Clonar un agente

Authorizations

Authorization
string
header
required

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

Headers

x-workspace-id
string<uuid>

Identificador del workspace multi-tenant. Obligatorio al autenticar con Authorization: Bearer, donde su ausencia devuelve 400 Workspace context is required. Con x-api-key es opcional: la llave ya identifica a su workspace y lo que mandes aquí se ignora.

Path Parameters

agentId
string<uuid>
required

Identificador del agente

Body

application/json

Datos necesarios para clonar un agente existente dentro del workspace activo.

  • versionId selecciona la versión origen desde la cual clonar blueprint/instructions.
  • clone controla qué componentes adicionales se copian.
  • El workflow (blueprint + stages) se clona siempre; triggers habilita copiar transiciones.
  • La conexión voice.calls no se clona; se crea una nueva conexión automáticamente.
name
string
required

Nombre del nuevo agente.

Required string length: 1 - 255
versionId
string<uuid>
required

Identificador de la versión origen a clonar.

clone
enum<string>[]
required

Componentes a clonar además del workflow (blueprint + stages).

Minimum array length: 1
Available options:
instructions,
tools,
webhooks,
stages,
triggers,
businessHours,
businessHourExceptions
description
string | null

Descripción operativa opcional para el nuevo agente.

Maximum string length: 1000
status
enum<string> | null

Estado inicial del agente clonado.

Available options:
inactive,
training,
active

Response

Agente clonado

agentId
string<uuid>
required
name
string
required
agentType
enum<string>
required
Available options:
chat,
voice
workspaceId
string<uuid>
required
status
enum<string>
required
Available options:
inactive,
training,
active,
archived,
building,
failed
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
totalCalls
integer
required

Total de llamadas realizadas por el agente.

Required range: x >= 0
totalOperationalDays
integer
required

Total de días operativos desde la creación del agente.

Required range: x >= 0
goalAchievedPercentage
number
required

Porcentaje de llamadas donde el objetivo fue alcanzado.

Required range: 0 <= x <= 100
version
object

La versión vigente del agente: la active si la hay y, si no, el borrador más reciente. Es de aquí de donde sale el identificador de versión que piden las rutas de blueprint, instrucciones y publicación — no hay un versionId plano. Se omite cuando el agente todavía no tiene ninguna versión.

description
string | null
avatarUrl
string<uri> | null

URL pública opcional utilizada para representar al agente.

debounceDelayMs
integer | null

Delay opcional antes de enviar respuestas (milisegundos).

Required range: x >= 0
ownerUserId
string<uuid> | null
knowledgeBaseIds
string<uuid>[]

Las bases de conocimiento que este agente consulta durante la conversación. Vacío significa que no consulta ninguna, no que no se sepa. Es la selección del cliente, leída del mismo sitio del que la lee el sync al publicar una versión, así que no puede divergir de lo que se toma como entrada al publicar. Al publicar, el proveedor de voz recibe sólo las que además están listas y son suyas: una base a medio indexar aparece aquí y todavía no viaja.