Referencia de la API
La API REST completa de DaRetriva — cada endpoint que usa la propia aplicación, generado directamente desde el esquema en vivo para que nunca quede desactualizado.
Referencia ReDoc →
Referencia de solo lectura, clara y navegable. El mejor punto de partida para explorar endpoints y esquemas.
Interfaz Swagger interactiva →
La misma referencia, pero le permite autenticarse y enviar solicitudes reales directamente desde el navegador.
Esquema OpenAPI →
El archivo openapi.json en bruto — impórtelo en Postman, Insomnia, o cualquier herramienta de generación de código.
Autenticación
Inicie sesión para recibir un JWT bearer, y envíelo en cada solicitud posterior. Los tokens caducan a las 24 horas por defecto; llame al endpoint de cierre de sesión para revocar uno antes.
curl -X POST https://daretriva.com/api/organization/login \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"••••••••"}'
# → { "token": "eyJhbGciOi...", "email": "you@example.com", ... }
curl https://daretriva.com/api/agents \
-H "Authorization: Bearer eyJhbGciOi..."Listar sus agentes de IA
curl https://daretriva.com/api/agents \
-H "Authorization: Bearer $TOKEN"Subir un documento
curl -X POST https://daretriva.com/api/upload \
-H "Authorization: Bearer $TOKEN" \
-F "file=@handbook.pdf" \
-F "dataset_id=your-dataset-id"Chatear con un widget público (sin autenticación)
Los endpoints del widget no requieren autenticación — limitados solo al agente detrás del token público. Vea la guía de integración del widget.
curl -X POST https://daretriva.com/api/public/widget/{token}/chat \
-H "Content-Type: application/json" \
-d '{"message":"What data sources do you support?","language":"en"}'