Massenlöschjob abrufen

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

Gibt Status und Zähler eines Jobs zurück, der mit Massenlöschung von Benutzern als Job anlegen erstellt wurde. Der Job ist running, bis jeder Benutzer ein Ergebnis hat, danach completed (keine Fehler) oder completed_with_errors (mindestens ein failed). pending ist die Anzahl der Benutzer, die noch kein Ergebnis haben; succeeded + not_found + failed + pending = total. Ein unterbrochener Job (zum Beispiel durch einen Neustart) läuft selbstständig weiter; fragen Sie diesen Endpunkt ab, bis status nicht mehr running ist.

Anfrage

Parameter	In	Erforderlich	Beschreibung
`job_id`	path	ja	Job-ID mit Präfix `job_`.

Antwort

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

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

CLI: keenauth jobs user-deletions get job_01h455vb4pex5vsknk084sn02q