Crear un agent

🚀 Servidor de producción

https://api.hiveflow.ai/api

POST

/agents

Genera el flow subyacente con los tres nodos pre-cableados (chat_input, llm, chat_output). Las skills seleccionadas quedan con scope en el flow del agent. Requiere permiso create_resources.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Agent creado

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.hiveflow.ai/api/agents' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "New Smart Agent",
    "description": "string",
    "objective": "string",
    "provider": "openai",
    "model": "gpt-4o-mini",
    "skillIds": [
        "string"
    ]
}'

Response Example

{
    "success": true,
    "data": {
        "_id": "string",
        "name": "Agente de Ventas",
        "description": "string",
        "provider": "openai",
        "model": "gpt-4o-mini",
        "objective": "string",
        "skills": [
            {}
        ],
        "apps": [
            {}
        ],
        "nodeCount": 0,
        "createdAt": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-08-17 04:40:21

Listar agents del usuario/organización

Obtener detalle de un agent