Obtenir une tâche d'export de données utilisateur

GET /v1/jobs/user-exports/{job_id} · autorisation users:export

Renvoie une tâche créée avec Exporter les données d'un utilisateur.

status Signification
queued En attente d'exécution.
running Le paquet est en cours de construction.
completed Le paquet est prêt ; file indique sa taille et son SHA-256. Téléchargez-le avant expires_at.
failed Aucun paquet ; failure_reason vaut too_large, user_deleted, source_unavailable ou attempts_exhausted.
expired Le paquet a été supprimé 7 jours après la fin de la tâche. Lancez un nouvel export.

Les exports demandés par les utilisateurs finaux depuis la page de leur compte ne sont pas visibles ici.

Requête

Paramètre Dans Obligatoire Description
job_id chemin oui Identifiant de la tâche, préfixé job_.

Réponse

200 OK.

{
  "id": "job_01j9xk3m7q8r2s4t6v8w0y2z4e",
  "kind": "subject",
  "source": "management_api",
  "user_id": "usr_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "status": "completed",
  "include_app_metadata": true,
  "include_ip": false,
  "file": {
    "size": 48213,
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
  },
  "failure_reason": null,
  "requested_by": { "type": "api_key", "id": "key_01j9xk3m7q8r2s4t6v8w0y2z4b" },
  "created_at": "2026-10-28T09:00:00Z",
  "started_at": "2026-10-28T09:00:02Z",
  "completed_at": "2026-10-28T09:00:09Z",
  "expires_at": "2026-11-04T09:00:09Z"
}

Erreurs

Chaque erreur est un corps application/problem+json avec un code stable.

HTTP code Quand
401 unauthenticated La clé d'API est absente, invalide ou révoquée.
403 insufficient_permissions La clé ne dispose pas de l'autorisation users:export.
404 not_found La tâche n'existe pas dans cet environnement (ou l'identifiant est mal formé).
429 rate_limited La limite de débit a été dépassée ; respectez Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez plus tard.

Exemple

curl https://api.eu.keenauth.com/v1/jobs/user-exports/job_01j9xk3m7q8r2s4t6v8w0y2z4e \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI : keenauth jobs user-exports get job_01j9xk3m7q8r2s4t6v8w0y2z4e