Flows y ejecuciones

Endpoints de Flow Studio: gestionar flujos, dispararlos y revisar sus ejecuciones.

Flujos

Método	Ruta	Descripción
GET	/workspaces/:workspaceId/flows	Listar flujos
POST	/workspaces/:workspaceId/flows	Crear flujo
GET	/workspaces/:workspaceId/flows/:id	Obtener flujo
PATCH	/workspaces/:workspaceId/flows/:id	Actualizar
DELETE	/workspaces/:workspaceId/flows/:id	Eliminar
POST	/workspaces/:workspaceId/flows/:id/validate	Validar
POST	/workspaces/:workspaceId/flows/:id/trigger	Disparar manualmente
POST	/workspaces/:workspaceId/flows/:id/regenerate-token	Regenerar token de webhook

Ejecuciones

Método	Ruta	Descripción
GET	/workspaces/:workspaceId/flows/:id/executions	Listar ejecuciones
GET	/workspaces/:workspaceId/flows/:id/executions/:execId	Detalle de ejecución
POST	/workspaces/:workspaceId/flows/:id/executions/:execId/cancel	Cancelar

Disparar por webhook (público)

Un flujo con trigger webhook se dispara con su token, sin API key:

POST /flows/run?token=WEBHOOK_TOKEN Copiar

Parámetros de query

Parámetro	Tipo	Descripción
token	string	Token del webhook del flujo.

El cuerpo (JSON) queda disponible en el flujo como {{triggerData.<campo>}}.

cURL

curl -X POST "https://api.waiify.com/flows/run?token=WEBHOOK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ana@empresa.com", "plan": "pro" }'

Node

await fetch('https://api.waiify.com/flows/run?token=WEBHOOK_TOKEN', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: 'ana@empresa.com', plan: 'pro' }),
});

Python

import requests

requests.post(
    "https://api.waiify.com/flows/run",
    params={"token": "WEBHOOK_TOKEN"},
    json={"email": "ana@empresa.com", "plan": "pro"},
)

Respuesta 200

{ "executionId": "e1a2b3-...", "status": "running" }