Exporter mes données
POST /fapi/v1/me/exports · appelé depuis l'hôte de connexion de l'environnement
Lance un export des données propres à l'utilisateur connecté (GDPR, articles 15 et 20). Le paquet est préparé en arrière-plan ; lorsqu'il est prêt, l'utilisateur reçoit un e-mail dans la langue de la requête, et le fichier peut être téléchargé avec Télécharger un export pendant 7 jours.
Le paquet est un fichier ZIP contenant un fichier JSON par type de données : profil, adresses e-mail et numéros de téléphone, identités liées, authentificateurs (sans secrets), sessions avec leurs adresses IP, appartenances aux organisations, autorisations OAuth, consentements et événements de connexion. Il ne contient jamais de hachage de mot de passe, de graine TOTP, de codes de récupération, de jetons ni de app_metadata.
Une authentification récente est requise : si la session n'a pas été vérifiée au cours des 5 dernières minutes, ou si l'utilisateur dispose d'un second facteur que la session n'a pas utilisé, la réponse est 401 step_up_required et rien n'est lancé. Si un export de l'utilisateur est encore en cours de préparation, cet export est renvoyé et aucun nouvel export n'est lancé. Un utilisateur peut demander au maximum 2 exports en 24 heures.
Requête
En-têtes :
| En-tête | Requis | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<hôte de connexion>. |
Corps :
{}
Réponse
202 Accepted :
{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "queued", "file": null, "failure_reason": null,
"created_at": "2026-11-03T09:30:00Z", "started_at": null, "completed_at": null, "expires_at": null}
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 401 | step_up_required |
Connexion datant de plus de 5 minutes, ou second facteur requis ; l'en-tête WWW-Authenticate contient max_age=300 (et acr_values lorsqu'un second facteur est requis). |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 429 | export_rate_limited |
Deux exports ont déjà été demandés au cours des 24 dernières heures ; réessayez après Retry-After. |
| 429 | rate_limited |
Trop d'exports sont en cours de préparation dans l'environnement ; réessayez après Retry-After. |
| 503 | service_unavailable |
L'annuaire des utilisateurs est temporairement indisponible ; réessayez après Retry-After. |
Exemple
curl -X POST https://example.keenauth.app/fapi/v1/me/exports \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
Données personnelles
Cet endpoint traite des données personnelles : demandes relatives à la vie privée (les enregistrements d'export propres à l'utilisateur). Données personnelles dans les API KeenAuth décrit ce qui est stocké, pendant combien de temps et comment elles sont supprimées. N'envoyez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.