hiveflow

Agregar nuevo nodo a un flujo

🚀 Servidor de producción

https://api.hiveflow.com/api

POST

/flows/{flowId}/nodes

Nodos

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hiveflow.com/api/flows//nodes' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "custom",
    "position": {
        "x": 100,
        "y": 100
    },
    "data": {
        "agentName": "Mi Agente",
        "llm": "openai",
        "model": "gpt-3.5-turbo",
        "prompt": "Analiza el siguiente texto",
        "agentObjective": "Análisis de sentimientos",
        "nodeType": "llm",
        "isAsync": false,
        "startNode": false,
        "conditions": [
            {
                "prompt": "¿El sentimiento es positivo?",
                "targetNodeId": "node-positive",
                "usePrompt": true,
                "operator": "contains",
                "value": "positivo"
            }
        ],
        "webhookConfig": {
            "url": "https://api.ejemplo.com/webhook",
            "method": "POST",
            "headers": {
                "Content-Type": "application/json",
                "Authorization": "Bearer token123"
            },
            "timeout": 30000
        },
        "variables": {
            "temperature": 0.7,
            "max_tokens": 1000
        }
    }
}'

Response Example

{
    "success": true,
    "node": {
        "id": "string",
        "type": "string",
        "position": {
            "x": 0,
            "y": 0
        },
        "data": {
            "agentName": "string",
            "llm": "openai",
            "model": "string",
            "agentObjective": "string",
            "url": "string",
            "prompt": "string",
            "nodeType": "llm",
            "conditions": [
                {
                    "prompt": "string",
                    "targetNodeId": "string",
                    "usePrompt": true
                }
            ]
        }
    },
    "message": "Nodo creado exitosamente"
}

Request

Path Params

flowId

string

required

ID del flujo

Body Params application/json

type

enum<string>

required

Allowed values:

customconditionalwebhookhttp_requestdata_processortrigger

Example:

custom

position

object

required

number

optional

Example:

100

number

optional

Example:

100

data

object

optional

agentName

string

optional

Example:

Mi Agente

llm

enum<string>

optional

Allowed values:

openaianthropicperplexitygemini

Example:

openai

model

string

optional

Example:

gpt-3.5-turbo

prompt

string

optional

Example:

Analiza el siguiente texto

agentObjective

string

optional

Example:

Análisis de sentimientos

nodeType

enum<string>

optional

Allowed values:

llmhttp_requestwebhookconditionaldata_processor

Example:

llm

isAsync

boolean

optional

Ejecutar de forma asíncrona

Default:

false

startNode

boolean

optional

Marcar como nodo de inicio

Default:

false

conditions

array [object {5}]

optional

Condiciones para nodos condicionales

webhookConfig

object

optional

Configuración para nodos webhook

variables

object

optional

Variables personalizadas del nodo

Example:

{"temperature":0.7,"max_tokens":1000}

Examples

Responses

🟢201Created

application/json

Nodo creado exitosamente

Body

success

boolean

optional

node

object (Node)

optional

string

optional

type

string

optional

position

object

optional

data

object

optional

message

string

optional

Example:

Nodo creado exitosamente

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Modified at 2025-06-19 15:26:15

Obtener todos los nodos de un flujo

Actualizar nodo existente