Revault Docs
Référence

Référence de l'API

Surface des endpoints HTTP de Revault, par domaine.

Toutes les routes sont préfixées par /api/v2. L'authentification se fait par cookie de session (HttpOnly) ou par en-tête Authorization: Bearer <token>. Sauf mention contraire, les routes exigent une session valide ; les exigences de plan et de rôle sont indiquées.

Cette référence décrit la surface fonctionnelle. Les schémas de corps de requête détaillés sont visibles dans l'interface (chaque action correspond à un appel listé ci-dessous).

Authentification & session

MéthodeEndpointAccèsDescription
POST/auth/loginpublicConnexion e-mail + mot de passe.
POST/auth/logoutsessionDéconnexion (révoque la session).
GET/mesessionIdentité + client actif.
GET/me/customerssessionClients accessibles.
POST/me/switch-customersessionChanger de client actif.
GET/PUT/me/profile, /me/passwordsessionProfil & mot de passe.

Tenants Okta

MéthodeEndpointAccèsDescription
GET/POST/okta-orgslicenceLister / connecter un tenant.
GET/PATCH/DELETE/okta-orgs/:idlicence (op/admin pour écrire)Détail / éditer / supprimer.
POST/okta-orgs/:id/testlicenceTester la connexion Okta.
GET/PUT/okta-orgs/:id/storagelicenceLire / configurer le stockage.
POST/okta-orgs/storage/testlicenceTester une connexion S3.
POST/okta-orgs/:id/migrate-storagelicenceMigrer les backups locaux vers S3 (par lots).

Sauvegardes & jobs

MéthodeEndpointAccèsDescription
POST/backups/runlicenceLancer une sauvegarde.
GET/backupslicenceLister (filtre oktaOrgId).
GET/backups/:idlicenceMétadonnées d'une sauvegarde.
GET/backups/:id/resourceslicenceRessources de l'instantané.
GET/backups/:id/resources/:resourceKeylicencePagination d'une ressource.
GET/backups/:id/searchlicenceRecherche plein texte.
GET/jobs/:idsessionStatut d'un job (polling).
GET/POST/PATCH/DELETE/schedulesProPlanifications (CRUD).

Restauration

MéthodeEndpointAccèsDescription
POST/restore/runProRestauration complète / sélective / simulation.
POST/restore/users/previewProPrévisualisation (≤ 2000 users).
POST/restore/users/applyProApplication (arrière-plan, illimité).
POST/restore/users/delete-liveProSuppression live (confirmation requise).

Conformité, récupérabilité, comparaison

MéthodeEndpointAccèsDescription
GET/compliance, /compliance/:oktaOrgIdProScores et tendance.
POST/compliance/:oktaOrgId/scanPro (op/admin)Relancer un scan.
GET/recoverabilityProRapport de récupérabilité.
GET/compare?backupA=&backupB=ProDiff de deux sauvegardes.

RGPD (Enterprise, admin)

MéthodeEndpointDescription
POST/rgpd/subject/analysisInventaire PII + registre Art. 30.
GET/rgpd/subject/searchRechercher une personne.
POST/rgpd/subject/exportExport Art. 15/20 (JSON ou ZIP).

Notifications, audit, équipe, licences

MéthodeEndpointAccèsDescription
GET/POST/notifications…sessionListe, non-lues, marquer lu, préférences, digest.
GET/audit-logadminJournal d'audit (filtrable).
GET/POST/PATCH/DELETE/users…admin (lecture: membre)Membres & invitations.
GET/POST/invites/:token…, /onboarding/:token…publicAccepter une invitation / onboarding.
GET/POST/licenses, /licenses/activateadminStatut & activation de licence.

Garde-fous transverses

  • requireAuth : session valide.
  • requireLicense : licence active (sinon license_required).
  • requirePlan('pro'|'enterprise') : plan suffisant (sinon plan_required).
  • requireOperator / requireActiveCustomerAdmin : rôle suffisant.
  • Isolation RLS : chaque requête est filtrée sur le client actif.

On this page