Référence API

Documentation complète de l'API REST d'InfoLens v1.

URL de base : http://localhost:24000 Auth : Bearer JWT ou clé API

Démarrage rapide

# Step 1: request a passwordless sign-in code (arrives by email; on a
# fresh install the console email provider prints it to the backend logs)
curl -s -X POST http://localhost:24000/v1/users/login/otp/request \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

# Step 2: verify the 6-digit code and capture the token
TOKEN=$(curl -s -X POST http://localhost:24000/v1/users/login/otp/verify \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","code":"123456"}' \
  | jq -r '.results.access_token.token')

# RAG query
curl -X POST http://localhost:24000/v1/retrieval/rag \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "What are the key findings?"}'

Authentification

Authentification des utilisateurs et gestion des jetons

GET/v1/users/auth/methodsDiscover enabled sign-in methodsPublic

POST/v1/users/login/otp/requestRequest a passwordless sign-in code by emailPublic

POST/v1/users/login/otp/verifyVerify the emailed code, receive tokensPublic

POST/v1/users/oauth/exchangeExchange an OAuth handoff code for tokensPublic

POST/v1/users/refresh-tokenRefresh access tokenToken

POST/v1/users/logoutInvalidate current sessionBearer

GET/v1/users/meGet current user profileBearer

GET/v1/tenants/meGet tenant context, roles, CASL abilitiesBearer

Documents

Importation, gestion et récupération de documents

POST/v1/documentsUpload a document (multipart)Bearer

GET/v1/documentsList documents with paginationBearer

GET/v1/documents/{id}Get document detailsBearer

DELETE/v1/documents/{id}Delete a documentBearer

GET/v1/documents/{id}/chunksList document chunksBearer

Recherche et RAG

Recherche sémantique et génération augmentée par récupération

POST/v1/retrieval/searchSemantic search across documentsBearer

POST/v1/retrieval/ragRAG query with AI-generated answerBearer

POST/v1/retrieval/agentConversational RAG agentBearer

Collections

Regrouper et organiser les documents

POST/v1/collectionsCreate a collectionBearer

GET/v1/collectionsList collectionsBearer

GET/v1/collections/{id}Get collection detailsBearer

DELETE/v1/collections/{id}Delete a collectionBearer

Gestion des tenants

Administration multi-tenant (nécessite des permissions d'administrateur)

POST/v1/tenantsCreate a new tenantSuperuser

GET/v1/tenantsList all tenantsSuperuser

GET/v1/tenants/{id}/rolesList tenant rolesAdmin

POST/v1/tenants/{id}/rolesCreate custom roleAdmin

GET/v1/tenants/{id}/usersList tenant usersAdmin

POST/v1/tenants/{id}/usersInvite user to tenantAdmin

GET/v1/tenants/{id}/auditQuery audit logAdmin