PulbotDocumentación

Armar flows por API

Puedes crear un flow completo (nodos y conexiones) por la API REST o por MCP. El resultado es el mismo que en el editor visual: el flow aparece en Pulbot y se puede abrir y editar.

¿Cuándo usarlo?

Cuando quieres generar flows desde tu sistema, por ejemplo uno por cliente, o dejar que un agente de IA los arme por ti.

Pasos

  1. 1Busca las herramientas que vas a usar: GET /api/v1/tools/?search=Gmail&category=all. Usa category=all para ver también las herramientas de Pulbot.
  2. 2Crea el flow: POST /api/v1/flows/ con {"name": "Mi flow"}. Guarda data.id.
  3. 3Agrega los nodos: PATCH /api/v1/flows/{id}/ con states. Cada nodo lleva un id provisional (tmp-…), action_tool (el id de la herramienta), content y style.position. Si el nodo usa un recurso, agrega resource_connector.
  4. 4Lee los ids reales de los nodos con GET /api/v1/flows/{id}/ (data.states[].id).
  5. 5Conecta los nodos: PATCH /api/v1/flows/{id}/ con solo transitions, cada una con before_state y next_state.

Referencia

Por MCP
create_flow, add_node, connect_nodes, configure_node y validate_flow. configure_node mapea las entradas de cada nodo igual que el editor.
Posición
Envía siempre style.position. Sin ella, los nodos aparecen encimados en el editor.
Conexiones
Al conectar, no envíes states en el mismo PATCH: los nodos se recrearían y cambiarían de id.
Activar
El flow nace inactivo. Lo activas desde el editor cuando esté listo.

Errores comunes

422
Falta un campo o el cuerpo no tiene el formato esperado. El detalle viene en data.
Nodo sin herramienta
action_tool tiene que ser un id que aparezca en GET /api/v1/tools/?category=all.

Siguiente paso

Importa la colección de Postman: incluye estos pasos con tests y los mismos pasos por MCP.

¿Necesitas ayuda?