📖 API Documentation
Referencia completa de los endpoints de Cortex
Envía un mensaje y recibe respuesta en streaming vía Server-Sent Events. Soporta múltiples verticales e historial de conversación.
{
"message": "¿Qué es Cortex?",
"vertical": "general",
"sessionId": "uuid-session",
"userId": "uuid-user",
"history": [{"role": "user", "content": "hola"}],
"stream": true
}data: {"stage":"thinking","data":{"message":"Analyzing request…"},"ts":"..."}
data: {"stage":"retrieving","data":{"message":"Searching knowledge base…","vertical":"general","model":"gpt-4o"},"ts":"..."}
data: {"stage":"verifying","data":{"message":"Verifying response…"},"ts":"..."}
data: {"stage":"generating","data":{"message":"Response generated.","sourcesCount":0},"ts":"..."}
data: {"stage":"done","data":{"text":"Cortex es una plataforma...","model_used":"gpt-4o","tokens":{"input":80,"output":120,"total":200},"latencyMs":1500},"ts":"..."}Devuelve el estado de salud del sistema, módulos activos y configuración.
{
"status": "ok",
"version": "0.1.0",
"uptime": 1203656,
"modules": {
"db": true,
"vector": false,
"ai": true,
"rag": false,
"profile": true,
"ideavault": true
},
"config": {
"port": 3000,
"env": "production",
"hasOpenAIKey": true,
"hasVectorDb": true
}
}Convierte texto a audio MP3 usando ElevenLabs (voz Victoria). Retorna audio/mpeg binario.
{
"text": "Hola, soy Cortex",
"voiceId": "Fd38GRHtJllY0CuguAy9"
}Content-Type: audio/mpeg
Binary MP3 data (~15-30KB per sentence)Retorna el schema completo de todas las bases de datos conectadas: tablas, columnas, tipos y conteo de filas.
{
"databases": [{
"name": "Main Database (nextcore)",
"type": "postgresql",
"status": "connected",
"tables": [{
"name": "conversations",
"rowCount": 5,
"columns": [
{"name": "id", "type": "uuid", "nullable": false},
{"name": "input", "type": "text", "nullable": false},
{"name": "response", "type": "text", "nullable": false}
]
}]
}]
}Sincroniza un usuario de Firebase Authentication con la base de datos PostgreSQL. Crea el usuario y perfil si no existen.
{
"firebaseUid": "firebase-uid-string",
"email": "user@email.com",
"displayName": "Felipe Mehr",
"photoURL": "https://..."
}{
"success": true,
"user": {
"id": "uuid-postgres-id",
"email": "user@email.com",
"display_name": "Felipe Mehr",
"plan": "free",
"firebase_uid": "firebase-uid"
},
"isNew": false
}Retorna todas las conversaciones de un usuario ordenadas por fecha.
{
"success": true,
"conversations": [{
"id": "uuid",
"session_id": "session-uuid",
"vertical": "general",
"input": "¿Qué es Cortex?",
"response": "Cortex es una plataforma...",
"model_used": "gpt-4o",
"tokens_input": 80,
"tokens_output": 120,
"latency_ms": 1500,
"created_at": "2026-03-19T..."
}],
"total": 5
}📊 Panel del Sistema
Cargando estado del sistema...