Obtenir une tâche de suppression d'utilisateurs en masse

GET /v1/jobs/user-deletions/{job_id} · autorisation users:delete

Renvoie l'état et les compteurs d'une tâche créée avec Créer une tâche de suppression d'utilisateurs en masse. La tâche est running jusqu'à ce que chaque utilisateur ait un résultat, puis completed (aucun échec) ou completed_with_errors (au moins un failed). pending est le nombre d'utilisateurs sans résultat pour l'instant ; succeeded + not_found + failed + pending = total. Une tâche interrompue (par exemple par un redémarrage) continue d'elle-même ; interrogez ce point de terminaison jusqu'à ce que status ne soit plus running.

Demande

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

Réponse

200 OK.

{
  "id": "job_01h455vb4pex5vsknk084sn02q",
  "status": "completed_with_errors",
  "filter": "organization",
  "organization_id": "org_01h455vb4pex5vsknk084sn02q",
  "total": 3,
  "succeeded": 1,
  "not_found": 1,
  "failed": 1,
  "pending": 0,
  "created_at": "2026-01-15T09:30:00Z",
  "completed_at": "2026-01-15T09:31:00Z"
}

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:delete`.
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-deletions/job_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI : keenauth jobs user-deletions get job_01h455vb4pex5vsknk084sn02q