Copiar un agente a una subcuenta

curl --request POST \
  --url https://api.getnexor.ai/api/public/sub-accounts/{sub_account_id}/agents/duplicate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source": {
    "master_workflow_id": "55555555-5555-4555-8555-555555555555"
  },
  "names": {
    "principal": "Sofía Andes"
  },
  "confirm": true
}
'

{
  "status": "created",
  "master_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "next_steps": [
    {
      "code": "<string>",
      "owner": "<string>",
      "blocking": true,
      "blocks": [
        "<string>"
      ],
      "label": {
        "en": "<string>",
        "es": "<string>"
      },
      "detail": {
        "en": "<string>",
        "es": "<string>"
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "<string>",
      "agent_ref": "<string>",
      "resource_name": "<string>",
      "fields": [
        "<string>"
      ]
    }
  ]
}

{
  "status": "created",
  "master_workflow_id": "55555555-5555-4555-8555-555555555555",
  "workflow_ids": [
    "33333333-3333-4333-8333-333333333333",
    "44444444-4444-4444-8444-444444444444"
  ],
  "next_steps": [
    {
      "code": "whatsapp_number",
      "owner": "client",
      "blocking": true,
      "blocks": [
        "whatsapp"
      ],
      "label": {
        "es": "Conectar el número de WhatsApp",
        "en": "Connect the WhatsApp number"
      },
      "detail": {
        "es": "El número y la cuenta de WhatsApp pertenecen al cliente origen. Selecciona un número activo del cliente destino.",
        "en": "The WhatsApp number and account belong to the source client. Select an active number from the target client."
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "client_whatsapp_number",
      "agent_ref": null,
      "resource_name": "whatsapp_number",
      "fields": []
    }
  ]
}

{
  "error": "invalid_source"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "sub_accounts_not_enabled"
}

{
  "error": "source_not_found"
}

{
  "error": "sub_account_inactive"
}

{
  "error": "referral_agent_not_duplicable"
}

{
  "error": "internal_error"
}

POST

sub-accounts

{sub_account_id}

agents

duplicate

curl --request POST \
  --url https://api.getnexor.ai/api/public/sub-accounts/{sub_account_id}/agents/duplicate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source": {
    "master_workflow_id": "55555555-5555-4555-8555-555555555555"
  },
  "names": {
    "principal": "Sofía Andes"
  },
  "confirm": true
}
'

{
  "status": "created",
  "master_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "next_steps": [
    {
      "code": "<string>",
      "owner": "<string>",
      "blocking": true,
      "blocks": [
        "<string>"
      ],
      "label": {
        "en": "<string>",
        "es": "<string>"
      },
      "detail": {
        "en": "<string>",
        "es": "<string>"
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "<string>",
      "agent_ref": "<string>",
      "resource_name": "<string>",
      "fields": [
        "<string>"
      ]
    }
  ]
}

{
  "status": "created",
  "master_workflow_id": "55555555-5555-4555-8555-555555555555",
  "workflow_ids": [
    "33333333-3333-4333-8333-333333333333",
    "44444444-4444-4444-8444-444444444444"
  ],
  "next_steps": [
    {
      "code": "whatsapp_number",
      "owner": "client",
      "blocking": true,
      "blocks": [
        "whatsapp"
      ],
      "label": {
        "es": "Conectar el número de WhatsApp",
        "en": "Connect the WhatsApp number"
      },
      "detail": {
        "es": "El número y la cuenta de WhatsApp pertenecen al cliente origen. Selecciona un número activo del cliente destino.",
        "en": "The WhatsApp number and account belong to the source client. Select an active number from the target client."
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "client_whatsapp_number",
      "agent_ref": null,
      "resource_name": "whatsapp_number",
      "fields": []
    }
  ]
}

{
  "error": "invalid_source"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "sub_accounts_not_enabled"
}

{
  "error": "source_not_found"
}

{
  "error": "sub_account_inactive"
}

{
  "error": "referral_agent_not_duplicable"
}

{
  "error": "internal_error"
}

Envía exactamente un origen:

master_workflow_id copia un agente con todas sus tareas. En la API, un agente es un master_workflow.
workflow_id copia una sola tarea. En la API, una tarea es un workflow.

{ "source": { "master_workflow_id": "55555555-5555-4555-8555-555555555555" }, "confirm": true }

Qué incluye la copia

La copia conserva la configuración, las etapas, los campos, las herramientas y las reglas del origen, y se crea pausada, así que todavía no contacta a nadie. Las conexiones ligadas a tu cuenta principal no se copian: números de WhatsApp y teléfono, canales, integraciones, bases de conocimiento, ofertas y anfitriones. next_steps y missing_connections indican qué debe conectar la subcuenta. Los pasos con blocking: true detienen los canales de blocks hasta completarlos. Después de conectar lo que falta, activa las tareas desde dentro de la subcuenta. Una subcuenta desactivada responde 409 sub_account_inactive. Reactívala primero con Reactivar subcuenta. Para el acceso a la función, los permisos y confirm, consulta Antes de empezar.

Autorizaciones

X-API-Key

string

header

requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

sub_account_id

string<uuid>

requerido

Sub-account ID, from items[].id in List sub-accounts. A malformed ID returns 400 invalid_sub_account_id.

Cuerpo

application/json

source

object

requerido

What to copy. Send exactly one of the two IDs.

Show child attributes

confirm

enum<boolean>

requerido

Must be true.

Opciones disponibles:

true

names

object

Optional new names for the copy. principal sets the name of the copied agent. Leave it out to keep the source names.

Show child attributes

Respuesta

status: "existed": the copy already existed; nothing new was created.

status

enum<string>

requerido

Opciones disponibles:

created,

existed

master_workflow_id

string<uuid> | null

requerido

The copied agent in the sub-account. null when the source was a single task.

workflow_ids

string<uuid>[]

requerido

The copied tasks in the sub-account, all paused.

next_steps

object[]

requerido

What the sub-account must set up before the copy goes live. blocking: true steps stop the channels listed in blocks.

Show child attributes

missing_connections

object[]

requerido

Connections and credentials that were left out of the copy.

Show child attributes

Última modificación el 1 de octubre de 2026

Empieza aquí

Quickstart

Referencia API

Configura y lanza

WhatsApp

Canales

Agentes

Reuniones

Integraciones

Cuenta

Bandeja de entrada

Herramientas para desarrolladores

Referencia de soporte

Copiar un agente a una subcuenta

Qué incluye la copia

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Qué incluye la copia

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Qué incluye la copia