Massen-Passwort-Zurücksetzen-Job abrufen

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

Gibt Status und Zähler eines Jobs zurück, der mit Massen-Passwort-Zurücksetzen als Job anlegen angelegt wurde. Es werden keine personenbezogenen Daten zurückgegeben. status durchläuft folgende Werte:

marking: Die ausgewählten Passwörter werden markiert; marked steigt.
waiting: nur lazy_then_bulk_reset; das Markieren ist abgeschlossen (marked_at), und der Job wartet auf deadline_at.
resetting: nur lazy_then_bulk_reset; die Frist ist abgelaufen, die Passwörter der Benutzer, die sie nicht geändert haben, werden gelöscht (passwords_deleted), und für Benutzer mit einer verifizierten primären Adresse wird eine E-Mail zum Zurücksetzen gesendet (emailed).
completed: Der Job ist abgeschlossen (completed_at). Ein on_login-Job wird abgeschlossen, sobald das Markieren fertig ist.

total ist die Anzahl verschiedener Benutzer bei einem user_ids-Job und 0 bei einem hash_algo-Job; not_found zählt IDs, die keine Benutzer dieser Umgebung sind oder kein Passwort haben.

Anfrage

Parameter	Ort	Pflicht	Beschreibung
`job_id`	Pfad	ja	Job-ID mit dem Präfix `job_`.

Antwort

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"
}

Fehler

Jeder Fehler ist ein application/problem+json-Body mit einem stabilen code.

HTTP	`code`	Wann
401	`unauthenticated`	Der API-Schlüssel fehlt, ist ungültig oder widerrufen.
403	`insufficient_permissions`	Dem Schlüssel fehlt die Berechtigung `user-credentials:write`.
404	`not_found`	Der Job existiert in dieser Umgebung nicht (oder die ID ist fehlerhaft).
429	`rate_limited`	Das Ratenlimit wurde überschritten; beachten Sie `Retry-After`.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut.

Beispiel

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