POST
/leads//automation/stop
Detiene toda la automatización de IA para el workflow run activo de un lead. La IA ya no responderá mensajes, la cadencia se pausa y las tareas programadas pendientes se cancelan.
Usa esto cuando un agente humano toma el control de la conversación o el lead solicita dejar de ser contactado.
Autentica cada solicitud con el header X-API-Key. Ver Autenticación.
Parámetros de Ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|
id | string (uuid) | Sí | ID del lead |
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|
workflow_id | string (uuid) | Sí | Agente para el cual detener la automatización |
Ejemplo
curl -X POST https://api.getnexor.ai/api/public/leads/lead-uuid/automation/stop \
-H "Content-Type: application/json" \
-H "X-API-Key: nxr_live_your_api_key" \
-d '{ "workflow_id": "workflow-uuid" }'
Respuestas
200 Automatización detenida
{
"success": true,
"workflow_run_id": "run-uuid",
"cadence_paused": true,
"tasks_cancelled": 2
}
{
"success": true,
"already_stopped": true,
"workflow_run_id": "run-uuid"
}
Campos de Respuesta
| Campo | Tipo | Descripción |
|---|
workflow_run_id | string | El workflow run que fue detenido |
cadence_paused | boolean | Si la cadencia fue pausada |
tasks_cancelled | integer | Número de tareas pendientes que fueron canceladas |
already_stopped | boolean | Retornado si la automatización ya estaba detenida (idempotente) |
400 workflow_id faltante
{
"error": "workflow_id is required"
}
404 No se encontró un run activo
{
"error": "No active workflow run found for this lead and workflow"
}
expired, converted).
401 Error de autenticación
Ver Autenticación. Última modificación el 18 de junio de 2026
