Ottenere un job di reimpostazione della password in blocco

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

Restituisce lo stato e i contatori di un job creato con Creare un job di reimpostazione della password in blocco. Non viene restituito alcun dato personale. status passa attraverso questi valori:

marking: le password selezionate vengono contrassegnate; marked cresce.
waiting: solo lazy_then_bulk_reset; il contrassegno è terminato (marked_at) e il job attende deadline_at.
resetting: solo lazy_then_bulk_reset; la scadenza è passata e le password degli utenti che non le hanno cambiate vengono eliminate (passwords_deleted), con un'e-mail di reimpostazione per quelli che hanno un indirizzo principale verificato (emailed).
completed: il job è terminato (completed_at). Un job on_login si completa non appena il contrassegno è terminato.

total è il numero di utenti distinti per un job user_ids e 0 per un job hash_algo; not_found conta gli ID che non sono utenti di questo ambiente oppure non hanno una password.

Richiesta

Parametro	In	Obbligatorio	Descrizione
`job_id`	percorso	sì	ID job, con prefisso `job_`.

Risposta

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

Errori

Ogni errore è un corpo application/problem+json con un code stabile.

HTTP	`code`	Quando
401	`unauthenticated`	La chiave API è mancante, non valida o revocata.
403	`insufficient_permissions`	La chiave non ha il permesso `user-credentials:write`.
404	`not_found`	Il job non esiste in questo ambiente (oppure l'ID non è valido).
429	`rate_limited`	È stato superato il limite di frequenza; rispettare `Retry-After`.
503	`service_unavailable`	Una dipendenza non è temporaneamente disponibile; riprovare più tardi.

Esempio

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