Ottenere un job di eliminazione utenti in blocco

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

Restituisce lo stato e i contatori di un job creato con Creare un job di eliminazione utenti in blocco. Il job è running finché ogni utente non ha un esito, poi diventa completed (nessun errore) o completed_with_errors (almeno un failed). pending è il numero di utenti che non hanno ancora un esito; succeeded + not_found + failed + pending = total. Un job interrotto (per esempio da un riavvio) continua da solo; interroga questo endpoint finché status non è più running.

Richiesta

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

Risposta

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

Errori

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

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

Esempio

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