Skip to main content
Base URL tipica: http://localhost:8000 (ajusta host y puerto en despliegue).

​
Rutas custom de OpenAgno

​
Admin

MetodoRutaDescripcion
GET/admin/healthEstado del runtime, agentes, canales, modelo y scheduler
POST/admin/reloadSolicitar reload al supervisor
POST/admin/fallback/activateActivar fallback manualmente
POST/admin/fallback/restoreRestaurar modelo principal
Estas rutas tienen rate limiting. Actualmente no usan X-API-Key; protegelas con red privada o reverse proxy si las expones en produccion.

​
Knowledge custom

MetodoRutaDescripcion
POST/knowledge/uploadSubir documento
POST/knowledge/ingest-urlsIngestar URLs
GET/knowledge/listListar documentos
DELETE/knowledge/{doc_name}Eliminar documento
POST/knowledge/searchBusqueda semantica
Si defines OPENAGNO_API_KEY, estas rutas requieren el header X-API-Key.

​
WhatsApp QR

MetodoRutaDescripcion
GET/whatsapp-qr/statusEstado del bridge QR
GET/whatsapp-qr/codePagina HTML con QR
GET/whatsapp-qr/code/jsonQR como JSON
POST/whatsapp-qr/incomingMensajes entrantes del bridge QR

​
WhatsApp Cloud API

MetodoRutaDescripcion
GET/whatsapp/webhookVerificacion de webhook con Meta
POST/whatsapp/webhookRecepcion de eventos de WhatsApp Cloud API

​
Rutas nativas de AgentOS

El runtime tambien expone rutas propias de AgentOS. Las mas utiles para operacion son:
GrupoRutas principales
Agentes/agents, /agents/{agent_id}/runs
Teams/teams, /teams/{team_id}/runs
Sesiones/sessions, /sessions/{session_id}, /sessions/{session_id}/runs
Memorias/memories, /memory_topics, /optimize-memories
Schedules/schedules, /schedules/{schedule_id}, /schedules/{schedule_id}/trigger
Registry / config/registry, /config, /components, /models
Observabilidad/health, /metrics, /traces, /eval-runs

​
Documentacion generada

  • /docs
  • /redoc
  • /openapi.json

​
Ejemplos

Health check: 
curl http://127.0.0.1:8000/admin/health
Busqueda custom de knowledge: 
curl -X POST http://127.0.0.1:8000/knowledge/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"OpenAgno","max_results":3}'
Para seguridad, rate limit y firma de WhatsApp, revisa Seguridad.