Actualizar Estructura

PATCH /workflows/:id/structure Agrega o edita los statuses del funnel y los campos personalizados de un agente. Las filas se upsertean por key: una key desconocida se inserta, una key existente se actualiza. Este endpoint nunca elimina — quitar un status o campo sigue siendo una acción deliberada del dashboard, así ningún lead que esté sentado en un status queda huérfano.

Parámetros de Ruta

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

Cuerpo de la Solicitud

Provee statuses, fields, o ambos.

Campo	Tipo	Requerido	Descripción
`statuses`	array	No	Statuses del funnel a upsertear (ver forma abajo)
`fields`	array	No	Campos personalizados a upsertear (ver forma abajo)

Forma de `statuses[]`

Campo	Tipo	Requerido	Descripción
`key`	string	Sí	Identificador estable. Si coincide con un status existente lo actualiza, si no inserta uno nuevo
`label`	string	Sí	Etiqueta visible (`name` también es aceptado)
`is_initial`	boolean	No	Marca el status de entrada del funnel
`is_terminal`	boolean	No	Marca un status de cierre del funnel
`sort_order`	integer	No	Al insertar, por defecto es el índice del array agregado después del máximo actual. Se ignora al actualizar — reordenar statuses existentes no se hace aquí

Forma de `fields[]`

Campo	Tipo	Requerido	Descripción
`key`	string	Sí	Identificador estable
`label`	string	Sí	Etiqueta visible
`type`	string	No	Uno de: `text`, `number`, `date`, `datetime`, `boolean`, `select`, `multiselect`, `email`, `phone`, `url`, `currency`. Por defecto `text`
`required`	boolean	No	Si el agente debe recolectar este campo antes de avanzar. Por defecto `false`
`sort_order`	integer	No	Mismo comportamiento de inserción/actualización que statuses

Respuestas

`200` — Actualizado

{
  "success": true,
  "workflow_id": "123e4567-e89b-12d3-a456-426614174000",
  "statuses_upserted": 2,
  "fields_upserted": 1
}

statuses_upserted / fields_upserted solo aparecen para los arrays que enviaste.

`400` — Error de validación

{
  "error": "Invalid input",
  "message": "Provide statuses and/or fields arrays"
}

También se devuelve como "each status needs a key and a label" o "each field needs a key and a label".

`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

Configurar Prompt

Configurar Prompts por Canal

​Parámetros de Ruta

​Cuerpo de la Solicitud

​Forma de statuses[]

​Forma de fields[]

​Respuestas

​200 — Actualizado

​400 — Error de validación

​401 — Error de autenticación

​404 — No encontrado

​500 — Error interno del servidor