1. Agents
hiveflow
  • Autenticación
    • Registrar nuevo usuario
      POST
    • Iniciar sesión
      POST
    • Solicitar reset de contraseña
      POST
    • Resetear contraseña con token
      POST
  • Autenticación Social
    • Iniciar autenticación con Google
      GET
    • Callback de autenticación con Google
      GET
    • Iniciar autenticación con GitHub
      GET
    • Callback de autenticación con GitHub
      GET
  • Perfil
    • Obtener perfil del usuario autenticado
      GET
    • Actualizar perfil del usuario
      PUT
  • API Keys
    • Listar API keys del usuario
      GET
    • Crear nueva API key
      POST
    • Revocar/eliminar API key
      DELETE
  • Flujos
    • Obtener todos los flujos del usuario
      GET
    • Crear nuevo flujo
      POST
    • Obtener flujo específico
      GET
    • Actualizar flujo completo
      PUT
    • Eliminar flujo
      DELETE
    • Archivar/desarchivar flujo
      PATCH
    • Actualizar nombre del flujo
      PATCH
  • Nodos
    • Eliminar entrada específica del historial del nodo
    • Limpiar todo el historial de nodos del flujo
    • Obtener tipos de nodos disponibles
    • Obtener todos los nodos de un flujo
    • Agregar nuevo nodo a un flujo
    • Actualizar nodo existente
    • Eliminar nodo
    • Obtener historial de ejecuciones del nodo
    • Limpiar historial completo del nodo
    • Duplicar nodo existente
    • Validar configuración del nodo
  • Conexiones
    • Obtener todas las conexiones de un flujo
    • Crear nueva conexión entre nodos
    • Actualizar conexión existente
    • Eliminar conexión entre nodos
    • Validar todas las conexiones del flujo
    • Crear múltiples conexiones en lote
    • Eliminar múltiples conexiones en lote
  • Triggers
    • Actualizar configuración de triggers del flujo
    • Regenerar API key del trigger del flujo
    • Actualizar configuración de triggers del nodo
    • Regenerar API key del trigger del nodo
    • Ejecutar flujo mediante trigger público
    • Ejecutar nodo específico mediante trigger público
  • Procesamiento
    • Procesar/ejecutar flujo completo
    • Detener ejecución del flujo
    • Obtener estado actual del flujo
    • Obtener estado de un proceso específico
    • Obtener historial de procesos del flujo
    • Procesar/ejecutar un nodo individual
  • IA
    • Generar flujo automáticamente con IA
  • LLM
    • Obtener modelos disponibles por proveedor
    • Procesar texto con un modelo LLM específico
    • Obtener lista de proveedores disponibles
  • MCP
    • Lista todos los servidores MCP registrados
    • Registra un nuevo servidor MCP
    • Obtiene información detallada de un servidor MCP
    • Actualiza la configuración de un servidor MCP
    • Elimina un servidor MCP
    • Conecta a un servidor MCP
    • Desconecta de un servidor MCP
    • Lista las herramientas disponibles en un servidor MCP
    • Ejecuta una herramienta MCP
    • Lista los recursos disponibles en un servidor MCP
    • Lee un recurso MCP
    • Habilita la reconexión automática
    • Deshabilita la reconexión automática
    • Ejecuta reconexión automática manual
  • WhatsApp
    • Listar todas las sesiones de WhatsApp
    • Inicializar nueva sesión de WhatsApp
    • Obtener estado de una sesión específica
    • Desconectar y eliminar sesión
    • Obtener lista de chats de una sesión
    • Obtener mensajes de un chat específico
    • Enviar mensaje a través de WhatsApp
    • Marcar mensajes como leídos
    • Obtener lista de grupos
    • Configurar webhook para eventos de WhatsApp
  • HiveFlow Database
    • Lista las colecciones del usuario
    • Crea una nueva colección para el usuario
    • Busca documentos en una colección del usuario
    • Inserta un documento en una colección del usuario
    • Actualiza un documento en una colección del usuario
    • Elimina un documento de una colección del usuario
    • Elimina una colección completa del usuario (metadatos y todos sus documentos)
    • Ejecuta una operación de memoria (save, search, update, delete)
    • Ejecuta múltiples operaciones de memoria en secuencia
  • Extension
    • Procesa datos enviados desde la extensión web
    • Obtiene flujos disponibles para la extensión
    • Obtiene el estado de un proceso iniciado desde la extensión
    • IA directa desde la extensión (sin flujo) con modelo default
    • IA directa sobre un PDF subido desde la extensión (extrae texto server-side)
    • Modelo default y lista permitida para la IA directa de la extensión
    • Lista los chats de la extensión del usuario (source web-extension)
    • Crea un chat de la extensión (se guarda como conversación HiveSmart con source web-extension)
    • Obtiene un chat de la extensión con sus mensajes
    • Renombra un chat de la extensión
    • Elimina un chat de la extensión
    • Reemplaza los mensajes del chat (máx 50) y auto-genera el título si es el default
  • Redis Integration
    • Valida la conexión a Redis
    • Configura automáticamente Redis como servidor MCP
    • Obtiene configuraciones predefinidas de Redis
  • Workflows
    • Create and optionally start a new workflow
    • List workflows with filtering
    • Get workflow details
    • Search workflows
  • Queries
    • Query workflow state
    • Get workflow event history
  • Signals
    • Send signal to workflow
    • Cancel workflow
    • Pause workflow
    • Resume workflow
  • Timers
    • Schedule timer for workflow
    • List workflow timers
    • Cancel timer
  • System
    • Get system overview
    • Get task queue statistics
    • Get worker statistics
    • Health check
  • Metrics
    • Get performance metrics
  • Hybrid System
    • Get hybrid system statistics
  • Agents
    • Listar agents del usuario/organización
      GET
    • Crear un agent
      POST
    • Obtener detalle de un agent
      GET
    • Listar sesiones de chat del agent
      GET
    • Crear una sesión de chat
      POST
    • Obtener una sesión con su historial
      GET
    • Eliminar una sesión
      DELETE
    • Enviar mensaje al agent
      POST
  • Hive Tools (App Instances)
    • Listar instancias (view_resources)
    • Crear instancia (edit_resources)
    • Detalle de la instancia (view_resources)
    • Reemplazar la instancia (edit_resources)
    • Eliminar la instancia (edit_resources)
    • Parche parcial del data (edit_resources)
    • ✨ Generar el playbook de un worker con IA (view_resources)
    • Re-firmar una URL de S3 caducada (view_resources)
    • Añadir mensaje a una conversación de la app (edit_resources)
    • Flows vinculados a una instancia (view_resources)
  • Careers
    • Enviar aplicación a una vacante
    • Listar aplicaciones (interno)
    • Actualizar estado de una aplicación
  • CLI
    • Iniciar device flow (sin auth)
    • Aprobar un device code (desde la web, autenticado)
    • Denegar un device code
    • CLI: sondear el estado del device flow (sin auth)
    • Generar token manual para el CLI
    • Verificar el token del CLI
    • Proxy LLM del agente nativo del CLI (formato Anthropic Messages)
  • Hive Apps
    • Listar Hive Apps
    • Crear una Hive App
    • Obtener una app
    • Actualizar una app
    • Eliminar una app
    • Obtener los archivos de código de la app
    • Actualizar archivos de código
    • Chatear con el constructor de la app
    • Vincular un flow como backend de la app
    • Desvincular el flow de la app
    • Crear un flow acorde a la app y vincularlo
    • Obtener el contrato de I/O app↔flow
    • Guardar el contrato de I/O
    • Iniciar el preview en vivo (sandbox)
    • Detener el preview
    • Crear snapshot de versión
    • Restaurar una versión
    • Desplegar la app a URL pública
    • Re-desplegar la app
    • Retirar la app de producción
    • Estado del deploy
  • Skills
    • Listar skills
    • Crear una skill
    • Obtener una skill
    • Actualizar una skill
    • Eliminar una skill
    • Activar/desactivar una skill
    • Resumen de tokens del contexto inyectado
    • Skills activas para un flow
    • Alternar una skill para un flow específico
  • Genius
    • Listar conversaciones con Genius
    • Crear una conversación
    • Obtener una conversación con su historial
    • Eliminar una conversación
    • Renombrar una conversación
    • Enviar mensaje a Genius
    • Cancelar la generación en curso
    • Enviar feedback de un mensaje
  • Organizaciones
    • Listar mis organizaciones
    • Crear organización
    • Detalle de la organización activa
    • Actualizar la organización (manage_settings)
    • Eliminar la organización (solo owner)
    • Catálogo de permisos por rol
    • Listar miembros (view_resources)
    • Cambiar rol de un miembro (manage_members)
    • Expulsar miembro (manage_members)
    • Invitar a la organización (manage_members)
    • Listar invitaciones (manage_members)
    • Aceptar una invitación
    • Listar workspaces de la organización
    • Crear workspace (manage_workspaces)
    • Actualizar workspace (manage_workspaces)
    • Eliminar workspace (manage_workspaces)
    • Listar equipos (view_resources)
    • Crear equipo (manage_teams)
    • Cambiar mi organización activa
    • Cambiar mi workspace activo
    • Presupuesto de la organización (manage_settings)
    • Credenciales LLM a nivel org (manage_settings)
    • Actualizar credenciales LLM de la org (manage_settings)
  • Remote Control
    • CLI: registrar la sesión de una terminal
    • CLI: latido de la sesión
    • CLI: desconectar la sesión
    • CLI: long-poll de prompts entrantes
    • CLI: entregar la respuesta de un prompt
    • CLI: streaming de pasos intermedios
    • CLI: espejar al hilo lo tecleado/respondido localmente
    • CLI: estado 'pensando' compartido
    • WEB: listar las terminales del usuario
    • WEB: enviar un prompt a una terminal
  • Procesos en ejecución (tiempo real) del usuario o de su organización
    GET
  • Schemas
    • Schemas
      • User
      • Flow
      • Node
      • Edge
      • Error
      • Success
    • MCPServer
    • RedisConnection
    • Agent
    • ChatSession
    • KanbanCard
    • WorkerHeartbeat
    • JobApplication
    • ExtensionData
    • ExtensionFlow
    • ExtensionProcessResponse
    • ExtensionFlowsList
    • ProcessStatus
    • HiveApp
    • HiveSkill
    • GeniusConversation
    • MCPTool
    • MCPResource
    • MCPServerInfo
    • MCPToolExecution
    • MCPResourceRead
    • MCPExecutionResult
    • MCPServerList
    • MCPConnectionResponse
    • RCSession
  1. Agents

Enviar mensaje al agent

🚀 Servidor de producción
https://api.hiveflow.ai/api
🚀 Servidor de producción
https://api.hiveflow.ai/api
POST
/agents/{agentId}/chat
Ejecuta el flow del agent con el mensaje. Consume créditos (credit check llm_call). Requiere permiso execute_flows.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200
Respuesta del agente
This response does not have a body.
🟠401
🟠402
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.hiveflow.ai/api/agents//chat' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "sessionId": "string",
    "message": "Quiero agendar una visita el sábado",
    "files": [
        {}
    ]
}'
Modified at 2026-08-17 04:40:21
Previous
Eliminar una sesión
Next
Listar instancias (view_resources)
Built with