# 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](/docs/api/fapi/me/exports/download) 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 :

```json
{}
```

## Réponse

`202 Accepted` :

```json
{"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

```bash
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](/docs/policies/personal-data) 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.