Obtenir une tâche de réinitialisation du mot de passe en masse

GET /v1/jobs/password-resets/{job_id} · autorisation user-credentials:write

Renvoie le statut et les compteurs d'une tâche créée avec Créer une tâche de réinitialisation du mot de passe en masse. Aucune donnée personnelle n'est renvoyée. status passe par les étapes suivantes :

marking : les mots de passe sélectionnés sont en cours de signalement ; marked augmente.
waiting : lazy_then_bulk_reset uniquement ; le signalement est terminé (marked_at) et la tâche attend deadline_at.
resetting : lazy_then_bulk_reset uniquement ; l'échéance est passée et les mots de passe des utilisateurs qui ne les ont pas modifiés sont en cours de suppression (passwords_deleted), avec un e-mail de réinitialisation pour ceux qui ont une adresse principale vérifiée (emailed).
completed : la tâche est terminée (completed_at). Une tâche on_login se termine dès que le signalement est terminé.

total est le nombre d'utilisateurs distincts pour une tâche user_ids et 0 pour une tâche hash_algo ; not_found compte les identifiants qui ne sont pas des utilisateurs de cet environnement ou qui n'ont pas de mot de passe.

Demande

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

Réponse

200 OK.

{
  "id": "job_01h455vb4pex5vsknk084sn02q",
  "mode": "on_login",
  "filter": "user_ids",
  "status": "completed",
  "total": 3,
  "marked": 2,
  "not_found": 1,
  "passwords_deleted": 0,
  "emailed": 0,
  "created_at": "2026-01-15T09:30:00Z",
  "marked_at": "2026-01-15T09:31: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 possède pas l'autorisation `user-credentials:write`.
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/password-resets/job_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI : keenauth jobs password-resets get job_01h455vb4pex5vsknk084sn02q