Actualizar Agente

PATCH /workflows/:id Renombra un agente, edita su descripción, o actívalo/pausalo. Los agentes nacen pausados al crearse vía API — esta es la única forma de encenderlos programáticamente.

Parámetros de Ruta

Parámetro	Tipo	Requerido	Descripción
`id`	string (uuid)	Sí	ID del agente

Cuerpo de la Solicitud

Provee al menos uno de los siguientes.

Campo	Tipo	Requerido	Descripción
`is_paused`	boolean	No	`false` activa el agente, `true` lo pausa
`name`	string	No	Nuevo nombre del agente
`description`	string	No	Nueva descripción del agente

Respuestas

`200` — Actualizado

{
  "success": true,
  "workflow_id": "123e4567-e89b-12d3-a456-426614174000",
  "is_paused": false,
  "pending_runs": 3
}

pending_runs solo aparece al activar, y refleja los leads cuya cadencia se reanuda de inmediato.

`400` — Error de validación

{
  "error": "Invalid input",
  "message": "Provide is_paused, name or description"
}

`400` — Activación bloqueada

Los agentes con goal_type: appointment necesitan al menos un tipo de reunión activo antes de poder activarse:

{
  "error": "Activation blocked",
  "message": "Configure at least one active meeting type before activating this workflow."
}

`401` — Error de autenticación

Ver Autenticación.

`404` — No encontrado

{
  "error": "Not found",
  "message": "Workflow not found"
}

`500` — Error interno del servidor

Última modificación el 10 de julio de 2026

Obtener Agente

Configurar Prompt

​Parámetros de Ruta

​Cuerpo de la Solicitud

​Respuestas

​200 — Actualizado

​400 — Error de validación

​400 — Activación bloqueada

​401 — Error de autenticación

​404 — No encontrado

​500 — Error interno del servidor